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Preface 



The map language and its use in writing 7090/7094 
programs are described in this publication. This sym- 
bolic language encompasses all 7090/7094 machine 
operations, extended machine operations, and special 
operation. In addition, map provides more than sixty 
pseudo-operations, including the powerful macro- 
facility, all of which are described in this publication. 

map language programs are processed by the 7090/ 
7094 assembly program, ibmap, which is a component 
of the 7090/7094 ibjob Processor and which operates 
under the ibjob Monitor. The facilities of iocs, Fortran, 
and cobol are accessible to the map user. 

To assist the user in making the most effective use of 
this flexible programming tool, basic information about 
the map language is provided in Part I of this publica- 
tion. Its main features and capabilities are outlined, and 
the constituents of map symbolic instructions are ex- 
plained. 

The pseudo-operations provided by map have been 
divided into classes according to function. Most of the 
pseudo-operations are described in Part II, where their 
formats are shown and their use in programs is ex- 
plained and demonstrated. 



The macro-facility is described separately in Part III. 

Five appendixes following Part III provide supple- 
mentary information related to the map language. 

It has been assumed that the reader is familiar with 
the contents of one of the following publications: 
IBM 7090 Principles of Operation, Form A22-6528 
IBM 7094 Principles of Operation, Form A22-6703 

The following related publications may also be use- 
ful, depending on individual interests and require- 
ments: 

IBM 7090/7094 IBSYS Operating System: System Mon- 
itor (IBSYS), Form C28-6248 

IBM 7090/7094 IBSYS Operating System: IBJOB Proc- 
essor, Form C28-6275 

IBM 7090/7094 IBSYS Operating System: Input/Out- 
put Control System, Form C28-6345 
IBM 7090/7094 Programming Systems: FORTRAN IV 
Language, Form C28-6274 

IBM 7090/7094 Programming Systems: COBOL Lan- 
guage, Form J28-6260 

Machine requirements for map language programs 
are given in the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6275. 



This edition, Form C28-6311-4, is a reprint of Form C28-6311- 
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Part I. Symbolic Programming Using MAP 



Programmers can communicate instructions to com- 
puters at three general language levels. The language 
of the computer itself is the most basic. At the highest 
level are scientific and commercial programming lan- 
guages, such as Fortran and cobol, respectively. 
Assembly-program languages like the map (Macro 
Assembly Program) language are at the intermediate 
level. 

Because the computer executes instructions at the 
machine-language level, a source program written at 
either of the other two levels must be reduced to a 
machine-language object program before it can be 
executed. Machine-language programming is theo- 
retically the most efficient, since no translation from 
source program to object program is required. For the 
programmer, however, programming in machine lan- 
guage is tedious and time consuming, and program- 
ming errors are more likely. 

A source program written in the Fortran language 
closely resembles the mathematical notation used to 
state a problem to be solved by traditional methods. 
The cobol language is based on English statements 
much like those that would be used to explain a pro- 
cedure. These languages are relatively easy to learn 
and to use because of their similarity to the ordinary 
languages of business and science. 

Source programs written in these languages are 
translated into machine-language programs within the 
computer by a compiler program. By using a compiler, 
the computer can produce an efficient machine- 
language program from a Fortran or cobol source 
program faster and more accurately than a programmer 
can. Such compiler languages thus offer marked advan- 
tages over machine-language programming. However, 
compiler languages are somewhat restrictive. Some 
programming features that are available when using 
machine language cannot be included in any present- 
day compiler. 

An assembly-program language is similar in structure 
to machine language. However, mnemonic symbols are 
substituted for each binary instruction code, and sym- 
bols provided by the programmer are substituted for 
the other fields of an instruction. An assembly-program 
language can also provide additional advantages be- 
yond machine-language programming. For example, 
pseudo-operations' can be provided, which often permit 
the coding of one instruction instead of many instruc- 
tions. Thus, an assembly program provides the pro- 
grammer with all the flexibility and versatility of 



machine language but with greatly reduced program- 
ming effort. In addition, error checking can be included 
to facilitate source program debugging. 



7090/7094 MAP Language Features 

Operations 

The 7090/7094 map (Macro Assembly Program) lan- 
guage can be used for all of the 7090/7094 machine 
operations, the extended machine operations, and the 
special machine operations. (All such operations rec- 
ognized by map are listed in Appendix A with supple- 
mentary information about them. ) In addition, the map 
language provides an extensive set of pseudo-opera- 
tions that supplement machine instructions. 

A pseudo-operation is any operation included in the 
map language that is not an actual machine operation, 
extended machine operation, or special machine opera- 
tion. Pseudo-operations are used by the programmer in 
much the same way as machine operations, map pro- 
vides more than sixty such pseudo-operations to meet 
a variety of programming needs. These pseudo-opera- 
tions, which are described in detail in Parts II and III, 
have been divided into classes according to function. 

Location-Counter Pseudo-Operations enable the pro- 
grammer to establish symbolic location counters and 
control their operation. 

Storage-Allocation Pseudo-Operations reserve areas 
of core storage. 

Data-Generating Pseudo-Operations introduce data 
into a program in any of a variety of formats. They are 
also used in combination to generate tables of data. 

Symbol-Defining Pseudo-Operations are used to as- 
sign specific values to symbols. 

Boolean Pseudo-Operations define symbols as Boolean 
quantities. 

Conditional- Assembly Pseudo-Operations base as- 
sembly of an instruction on programmer established 
criteria. 

Symbol-Qualifying Pseudo-Operations qualify sym- 
bols within sections of a program. 

Control-Section Pseudo-Operations delimit sections 
of a program, facilitating cross-referencing among pro- 
grams and among program segments. 

File-Description Pseudo-Operations define the re- 
quirements of input/output files used by the program. 

Operation-Defining Pseudo-Operations define or re- 
define symbols as operation codes. 
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Miscellaneous Pseudo-Operations indicate the end of 
a program, extend the variable field of an operation, 
and permit remarks to be entered into the assembly list- 
ing. 

Absolute-Assembly Pseudo-Operations specify the 
nunched output format of an absolute assembly. 

List-Control Pseudo-Operations specify the contents 
and format of an assembly listing. 

Special Systems Pseudo-Operations generate subrou- 
tine calling sequences. They may also be used to save 
and restore the index registers and indicators. 

Macro-Defining Pseudo-Operations are used to de- 
fine programmer macro-operations. They are used in 
conduction with the macro-related pseudo-operations, 
which extend the facilities of macro-operations. 

Macro-Operations 

The programmer macro-operation facility is a very 
flexible and powerful programming tool. Many pro- 
gramming applications involve a repetition of a pattern 
of instructions, often with parts of the instructions 
varied at each iteration. Using the macro-defining 
pseudo-operations, a programmer can define the 
pattern as a macro-operation. 

In defining the pattern, the programmer gives it a 
name that becomes the operation code used to gener- 
ate the pattern of instructions. Thus, the coding of a 
single instruction can cause the pattern of instructions 
to be repeated as often as desired. Moreover, parts of 
the instruction can be varied each time the sequence 
is repeated. The contents of any field of any instruction 
within the pattern may be varied, and even entire in- 
structions can be inserted in the sequence. The macro- 
operation facility is described in Part III. 

Location Counters 

During assembly, a location counter registers the next 
location to be assigned to an instruction. For most ma- 
chine instructions processed by the assembly program, 
the contents of the location counter in effect at that 
time (the "current" location counter) is increased by 
1. Some pseudo-operations may result in no increase, 
an increase of 1, or an increase of more than 1. 

map enables a programmer to create and control as 
many symuoiic location counters as ue neeus by using 
the location-counter pseudo-operations. Control can be 
transferred back and forth among them as often as 
desired. 

This feature permits instructions coded in one se- 
quence to be loaded in another, the establishment of 
constant tables, etc. 

Absolute and Relocatable Assemblies 

The control routines of the operating system occupy 
lower core storage. Therefore, a program may not be 



loaded into this area but must be loaded into the first 
unused machine location. However, the programmer 
need not knOw the address of this location, since the 
loader (ibldr) can automatically relocate each pro- 
gram segment to be loaded. 

The first address of a program segment to be exe- 
cuted is called the load address, and each succeeding 
instruction is loaded relative to that address. Thus, 
the address of an instruction at load time is the address 
assigned to it during assembly plus the load address 
of the program segment in which the instruction ap- 
pears. 

In a relocatable assembly, the assembly program pro- 
duces an object deck that is automatically relocated at 
execution time by ibldr. However, it may sometimes 
be desirable to load a program beginning at a certain 
fixed location in core storage. A program loaded in this 
way is said to have an absolute origin. The programmer 
specifies a certain location as the load address for that 
deck. ( An absolute origin may also be specified within 
a relocatable assembly. See the section "Relocation 
Properties of Symbols.") 

In absolute assemblies, output is in the standard 22- 
word-per-card format, which is specified on the sibmap 
control card and by the abs pseudo-operation. Output 
in this format cannot be handled by ibldr. Whether the 
assembly is absolute or relocatable is specified by the 
programmer on the sibmap card (see the publication 
IBM 7090/7094 IBSYS Operating System: IBJOB Proc- 
essor, Form C28-6275. ) 

Error Checking 

Source programs written in the map language are 
checked for a variety of errors, including format errors, 
table overflow errors, input/output errors, improper 
references, and incorrectly coded operations. In addi- 
tion, the severity of the error is indicated. 

In a normal assembly, messages are printed just after 
the assembly listing. All messages for a given card are 
printed together, and the card groups are printed in 
ascending sequence. Correlation with the listing is ac- 
complished by printing the line number, which is as- 
signed by the assembly program, in the left margin of 
the listing for each card that requires a message. 

n. list Oi map error messages anu an explanation oi 
the severity code used are included in the publication 
IBM 7090/7094 IBSYS Operating System: IBJOB Proc- 
essor, Form C28-6275. 



Forming Symbolic Instructions 

Instruction Fields 

In the map language, each symbolic instruction is 
punched on a separate standard ibm card. A single 



instruction may have as many as five parts, occupying 
five fields on the card. 

THE NAME FIELD 

An instruction may be given a symbolic name by the 
programmer, so that references may be made in other 
instructions to the named instruction. (Other methods 
are also available for referring from one instruction to 
another. For example, see the section "Relative Ad- 
dressing." ) 

The use of a name is generally optional. However, 
some pseudo-operations do require a symbol in the 
name field. Name-field and other requirements of each 
of the pseudo-operations are explained in Parts II and 
III. Also, the specifications for symbols used in the 
name field are given in the section "Symbols." 

The name given to a symbolic instruction is from 1 
to 6 characters long, and it occupies columns 1 through 
6 on the card. 

THE OPERATION FIELD 

The machine operation code, pseudo-operation code, 
programmer macro-operation code, or an operation 
code previously defined by one of the operation- 
defining pseudo-operations appears in the operation 
field. 

The operation field is punched beginning in column 
8. Column 7 separates the name field from the opera- 
tional field. Column 7, which is usually left blank, is 
ignored by the assembly program. 

The character asterisk ( * ) may be used immediately 
to the right of some operation codes to indicate 
indirect addressing. Those machine instructions that 
are indirectly addressable are indicated in Appendix 
A. If indirect addressing is specified for an instruction 
in which it is not permitted, the asterisk ( * ) is ignored 
and a low-severity error message is issued. 

The operation field is usually restricted to a maxi- 
mum of six characters. However, an operation code of 
six characters defined by one of the operation-defining 
pseudo-operations may be followed by an asterisk ( * ) 
to indicate indirect addressing. 

THE VARIABLE FIELD 

The variable field of a symbolic instruction may con- 
tain subfields, separated by commas. 

In machine instructions, these subfields contain the 
address, tag, and/or decrement (or count) parts of 
instruction, depending on the requirements of the 
particular instruction. These parts of the variable field 
are supplied in the order: address, tag, decrement. 

The subfields that are required, optional, or not per- 
mitted in the variable fields of all 7090/7094 machine 
instructions, extended machine operations, and special 
operations are indicated in Appendix A. 



In pseudo-operations, the subfields of the variable 
field may contain symbols, symbolic expressions, and 
literals. The contents of the variable field specified for 
each of the map pseudo-operations is given in Parts II 
and III. 

A null subfield is indicated as being present but as 
having no value. If a null subfield is at the beginning 
of the variable field, it is indicated by a single comma. 
If it is between two other subfields, it is expressed by 
two consecutive commas. A null subfield at the end of 
the variable field is represented by a single comma 
followed by a blank. 

If a subfield that is not used in the variable field ( an 
irrelevant subfield ) is to be followed by a subfield that 
is required (a relevant subfield), the irrelevant subfield 
must be indicated. Irrelevant subfields at the end of 
the variable field may be indicated as null or may be 
omitted entirely. For example, the following pairs of 
instructions are equivalent: 

TXH 0,0,1 

TXH „1 

IORP ALPHA,0,1 

IORP ALPHA„1 

CLA ALPHA,0 

CLA ALPHA 

TXH ALPHA,0,0 

TXH ALPHA,, 

PXA 0,0 
PXA 

In the last two pairs, the commas may not be omit- 
ted, since the assembly program checks for a minimum 
number of subfields. The txh instruction requires three 
subfields, while the pxa instruction requires two. These 
subfields are not irrelevant and must be included. 

The variable field is separated from the operation 
field by at least one blank column. The variable field 
may begin in column 12 but may never begin after 
column 16. The variable field cannot extend beyond 
column 72. An instruction having a variable field ex- 
tending into column 72 may not have a comments field. 
However, the variable field of most instructions may 
be extended over more than one card, each having its 
own comments field, by using the etc pseudo-opera- 
tion. 

THE COMMENTS FIELD 

The comments field is included for the convenience of 
the programmer and does not affect execution of the 
program. This field is generally used for explanatory 
remarks. (See also the section "The Asterisk (*) Re- 
marks Cards.") 

A blank precedes the comments field to separate it 
from the variable field. This field extends through 
column 72 on the card. If there is a blank variable 
field, the comments field may begin as soon as column 
17. An example of the use of the comments field is 
shown in Figure 1. 
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Figure 1. Example of MAP Coding Shows Use of Comments Field 
THE SEQUENCE FIELD 

Symbolic instructions may be numbered for identifica- 
tion in the sequence field, which includes columns 73 
through 80 on the card. 

THE ASTERISK ( * ) REMARKS CARD 

The remarks card is a special source card with an as- 
terisk ( * ) in column 1 and any desired information in 
the rest of the card. 

Any card with an asterisk in column 1 is treated by 
the assembly program as a remarks card, and its con- 
tents are printed out in the assembly listing. It has no 
other effect on the assembly. 

Remarks cards may be grouped and may appear 
anywhere in a program except in macro-operations or 
between etc cards. They are frequently used at the 
beginning of a program to state the problem to be 
solved, to describe the technique used, etc. ( map also 
makes a remarks card available by using the pseudo- 
operation rem, which is described in the section "The 
rem Pseudo-Operation." ) 

Examples of remarks cards are shown in Figure 1, 
or. tttqII oc methods of codin nr a variable field. 

Symbols 

The symbolic names used in the name and variable 
fields of symbolic instructions consist of one to six non- 
blank bcd characters (see Appendix E). At least one 
nonnumeric character must be included, but none of 
the following ten characters may be used: 



+ (plus sign) = 

— ( minus sign ) , 

* ( asterisk ) 

/ (slash) ( 

$ (dollar sign) ) 

Parentheses in a symbol cause a low-severity warn- 
ing message to be printed, but assembly is not affected. 
However, the ( )ok option specified on the sibmap 



( equal sign ) 
( comma ) 
( apostrophe ) 
( left parenthesis ) 
( right parenthesis ) 



control card (see the publication IBM 7090/7094 

IBSYS Operating System: IB] OB Processor, Form: 

C28-6275) indicates that parentheses in symbols are 

desired, and no message will be printed. 

Examples of valid symbols are: 

A 3.2XY 

37B2 DECLOC 

DELTA 

Conversely, the following are not valid symbols for 

the reasons indicated: 

A + B ( invalid character ) 

3921 ( no nonnumeric characters ) 

A2B4C6D ( more than six characters ) 

Defining Symbols 

When a symbol has been assigned a value, it is said 
to be defined. The assigned value can be the address 
of a location within core storage, an arbitrary quantity 
specified by the programmer, or a dependent value 
assigned by the assembly program. Values are assigned 
to symbols during and after the first of the two passes 
made by the assembly program over the source pro- 
gram. Further information about the assembly pro- 

•_ .-J_J .•„ ii.„ .Ul: — 4-;~~ TDA/f 7/KWI /7Y"10/f 

grain is piuvmeu in uic puunt-auun hulvi. , w\j/ « <ywi 

Operating System: IBJOB Processor. Form C28-6275. 

O fq i ti ci ry SyiriDOis 

Several types of symbols are used in the variable fields 
of machine instructions and in most of the pseudo- 
operations. 

1. Location symbols are so called because of their 
appearance in the name field of an instruction. During 
the first pass of the assembly program, location sym- 
bols in the variable field of an instruction are immedi- 
ately assigned a value called an S-value. The S-value 
is 1 if the symbol has previously appeared in the name 
field of an instruction and if it has not. After the first 
pass has been completed, these symbols are assigned 



the value of the address of the instruction in which 
they appeared as a name-field symbol. 

Absolute symbols are location symbols having fixed 
values that are independent of any relocation of the 
program segment. 

2. Virtual symbols are used in the variable field of 
an instruction and never appear in any name field. 
Virtual symbols, which have special functions in map, 
are defined at load time. The S-value is 0. ( For further 
information, see the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6275. ) 
Virtual symbols are permitted only in a relocatable 
assembly. In an absolute assembly, virtual symbols are 
flagged as undefined. 

Immediate Symbols 

Immediate symbols are created by using them in the 
name field of the set pseudo-operation. Immediate 
symbols are assigned a value ( S-value ) during the first 
pass of the assembly program. Immediate symbols may 
also be redefined throughout a program by using ad- 
ditional set pseudo-operations. (See the section "The 
set Pseudo-Operation.") The final value of an imme- 
diate symbol is used in the second pass. 

Relocation Properties of Symbols 

An absolute origin may be specified in a relocatable as- 
sembly, which should not be confused with an absolute 
assembly. If an absolute origin is given in a relocatable 
assembly, any symbols whose definitions depend on 
that origin are absolute. However, instructions under 
the absolute origin may refer to symbols elsewhere in 
the program. The assembly can be returned to the re- 
locatable mode by subsequently specifying a relocat- 
able origin. 

Under the following conditions, symbols are abso- 
lute even if they appear within a relocatable assembly: 

1. Symbols whose values depend on an absolute 
origin (as a result of using the org or begin pseudo- 
operations ) 

2. Symbols defined by the bool, rbool, and lbool 
pseudo-operations 

3. Symbols defined by the equ or syn pseudo-opera- 
tions and whose values reduce to a constant 

4. Symbols defined by a max or min pseudo-opera- 
tion that yield a constant 

5. Symbols used in the variable field of type D in- 
structions 

Literals 

Literals provide a simple means for introducing data 
words and constants into a program. For example, if a 
programmer wishes to add the number 1 to the con- 
tents of the accumulator, he must have the number 1 at 
some location in storage. 



In contrast to other types of subfields, the contents of 
a literal subfield is itself the data to be operated on. 
The appearance of a literal directs the assembly pro- 
gram to prepare a constant equal in value to the con- 
tent of the literal subfield. The assembly program 
replaces the subfield of the variable field of the in- 
struction containing the literal with the address of the 
constant thus generated. 

There are three types of literals — decimal, octal, and 
alphameric. 

DECIMAL LITERALS 

A decimal literal consists of the character = followed 
by a decimal data item. Three types of decimal data 
items are recognized by map: 

Decimal Integers. A decimal integer is one or more 
of the digits through 9, and it may be preceded by a 
plus or minus sign. Maximum size of the decimal in- 
teger is 2 35 — 1. 

Floating-Point Numbers. A floating-point number 
has two components. 

1. The principal part is a signed or unsigned decimal 
number, which may be written with or without a deci- 
mal point. The decimal point may appear at the be- 
ginning, at the end, or within the decimal number. If 
an exponent part is present, the decimal point may be 
omitted, in which case it is assumed to be at the right 
end of the decimal number. The principal part cannot 
exceed twenty digits. If it does, the number will be 
truncated and only the first twenty digits will be used. 

2. The exponent part consists of the letters e or ee 
followed by a signed or unsigned decimal integer. 
(The letters ee indicate a double-precision floating- 
point number. ) The exponent part may be omitted. If 
the exponent part is used, it must follow the principal 
part. The exponent part cannot exceed two digits. If it 
does, it will be truncated and only the first two digits 
will be used. 

A floating-point number is converted to a normalized 
floating-point binary word. The exponent part, if pres- 
ent, specifies a power of ten, by which the principal 
part is multiplied during conversion. For example, all 
of the following floating-point numbers are equivalent 
and are converted to the same floating-point binary 
number. 

3.14159 

31.4159E-1 

314159.E-5 

314159E-5 

.314159E1 

The octal representation of this number is 
202622077174 

Similarly, the number .314159EE1 is converted to a 
double-precision floating-point number. Its octal repre- 
sentation is 

202622077174 
147015606335 
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Fixed-Point Numbers. A fixed-point number has 
three components. 

1. The principal part is a signed or unsigned decimal 
number, which may be written with or without a deci- 
mal point. The decimal point may appear at the begin- 
ning, at the end, or within the decimal number. If the 
decimal point is omitted, it is assumed to be at the 
right end of the decimal number. The principal part 
cannot exceed twenty digits. If it does, the number will 
be truncated and only the first twenty digits will be 
used. 

2. The exponent part consists of the letters e or ee 
followed by a signed or unsigned decimal integer. 
( The letters ee indicate a double-precision fixed-point 
number.) The exponent part may be omitted. If the 
exponent part is used, it must follow the principal part. 
The exponent part cannot exceed two digits. If it does, 
it will be truncated and only the first two digits will 
be used. 

3. The binary-place part consists of the letters b or 
bb followed by a signed or unsigned decimal integer. 
(The letters bb indicate a double-precision fixed-point 
number. ) The binary-place part must be present in a 
fixed-point number and must come after the principal 
part. If the number has an exponent part, the binary- 
place part may either precede or follow the exponent 
part. The binary-place part may not exceed two digits. 
If it does, the number will be truncated and only the 
first two digits will be used. 

A fixed-point number is converted to a fixed-point 
binary number that contains an understood binary 
point. The binary-place part specifies the location of 
this understood binary point within the word. The 
number that follows the letters b or bb specifies the 
number of binary places in the word at the left of the 
binary point. The sign bit is not counted. Thus, a 
binary-place part of zero specifies a 35-bit binary frac- 
tion. B2 specifies two integral places and 33 fractional 
places. B35 specifies a binary integer. B2 specifies a 
binary point located two places to the left of the 
leftmost bit of the word; that is, the word would con- 
tain the low-order 35 bits of a 37-bit binary fraction. As 
with floating-point numbers, the exponent part, if pres- 
ent, specifies a power of ten, by which the principal 
part will be multiplied during conversion. 

For example, the following fixed-point numbers all 
specify the same bit configuration, but not all of them 
specify the same location for the understood binary 
point: 

22.5B5 
11.25B4 
1125E-2B4 
ajj I iiii 

All of the above fixed-point numbers are converted 



to the binary configuration having the octal repre- 
sentation 

264000000000 
The following double-precision fixed-point numbers 

10BB35 
1B35EE1 
1BB35E1 
1BB35EE1 

are converted to the binary configuration having the 
octal representation 

000000000012 
000000000000 

Double-precision literals are stored in consecutive 
locations. The first or high-order part is automatically 
stored in an even location relative to the beginning of 
the Literal Pool. If these literals are to be used as oper- 
ands in double-precision operations (7094), an even 
pseudo-operation must be inserted immediately before 
the lorg pseudo-operation if there is one; otherwise it 
must be inserted before the end pseudo-operation. 

OCTAL LITERALS 

An octal literal consists of the two characters =0 
followed by an octal integer. 

An octal integer is a string of not more than twelve 
of the digits through 7, and it may be preceded by a 
plus or minus sign. 

Examples of octal literals are: 



=0123 
= + 123 
= 0-123 



000000000123 
000000000123 
400000000123 



ALPHAMERIC LITERALS 

An alphameric literal consists of the two characters 
= H followed by exactly six alphameric characters. 
The six characters following the H are treated as data 
even if one or more of them is a comma or a blank. 
Examples of alphameric literals are: 

= H12ABCD 

= HTADbbb, where b represents a blank 

Writing Expressions 

The programmer writes expressions to represent the 
subfields of the variable field of symbolic instructions. 
Expressions are also used in the variable fields of many 
of the pseudo-operations in accordance with the rules 
set forth for each specific case. 

Expressions are comprised of elements, terms, and 
operators. 

ELEMENTS 

An element is the smallest component of an expression 
and is either a single symbol or a single integer less 
than 2 15 . The asterisk ( *) may be used as an element 
representing the location of the instruction in which it 
appears. 
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Examples of valid elements are: 

A 

427 

ALPHA 

TERMS 

A term is a group of one or more elements and the 
operators * (indicating multiplication) and / (indi- 
cating division). 

A term consists of one or more elements, with each 
element separated by an operator. A term must begin 
and end with an element. Two operators or two ele- 
ments in succession are never permissible. 

Examples of valid terms are: 

A A*B 

427 C/1409 

ALPHA BETA*GAMMA/DELTA 

There is no ambiguity between using the asterisk 

as an element and its use to denote multiplication, since 

position always makes clear its intended function. For 

example, a field coded 

would be interpreted as "the location of this instruction 
multiplied by B." Since a term must begin with an 
element, the first asterisk must be an element. The 
second asterisk must be an operator, which is required 
between two elements. 

EXPRESSIONS 

An expression is a group composed of one or more 
terms and the operators + (signifying addition) and 
— ( signifying subtraction ) . 

An expression consists of one or more terms, with 
each term separated by a plus or minus sign. Two op- 
erators or two terms in succession are never permiss- 
ible. However, an expression may begin with a plus 
or minus sign. Examples of valid expressions are: 

A 

ALPHA 

ALPHA*BETA 

-A/B 

A*B-C/D + E*2303 

*-A+B*C 

The asterisk in the last example is used first as an 

element and then as an operator. 

Evaluating Expressions 

In evaluating expressions, elements are evaluated first, 
then individual terms, and finally the complete expres- 
sion. The following procedure is used in evaluating 
expressions: 

1. Each element is replaced with its numeric value. 

2. Each term is evaluated by performing the indi- 
cated multiplications and divisions from left to right. 
In division, the integral part of the quotient is retained 
and any remainder is discarded immediately. For ex- 
ample, the value of the term 5/2*2 is 4. 



In evaluating a term, division by zero is the same as 
division by one and results in the original dividend. 
Division by zero is not regarded as an error. 

3. Terms are combined from left to right in the order 
in which they occur, with all intermediate results re- 
tained as 35-bit signed numbers. 

4. Finally, if the result is negative, it is comple- 
mented; in either case, only the rightmost 15 bits are 
retained. 

Grouping of terms by parentheses or any other 
means is not permitted. However, a product such as 
A(R-C) can be written simply a*r-a*c. 

The expression ** may be used to designate a field 
the value of which is to be computed and inserted by 
the program. It is an absolute expression having a value 
of zero. 

Rules for Forming Expressions 

The use of expressions is sometimes affected by whether 
elements within the expression are relocatable, abso- 
lute, or a combination of both. 

In a relocatable assembly, an expression that con- 
tains more than one symbol is generally complex. An 
expression that includes a control-section name is also 
complex. In addition, any expression that contains a 
complex element is itself complex. 

In an absolute assembly, all expressions are absolute. 

Relocatable and complex expressions are usually 
evaluated at load time, when absolute values have 
been assigned to symbols as part of the loading process. 
However, in pseudo-operations that affect location 
counters (such as res, rss, and regin) or that define 
symbols (such as max and min), the variable field 
must be evaluated before load time. For further in- 
formation, see the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Processor, Form C28-6275. 
The rules that must be followed in using expressions 
are provided in the discussions of the pseudo- 
operations. 

Boolean Expressions 

A Boolean expression is evaluated as an 18-bit Boolean 
quantity, unlike the 15-bit integer that normally results 
from the evaluation of an expression. Elements within 
a Boolean expression must be constant. All integers are 
specified as octal integers. An expression is Boolean if: 

1. It appears in the variable field of a Boolean 
pseudo-operation (hool, rrool, lrool; see the section 
"Boolean Pseudo-Operations" ) ; 

2. It appears as an octal subfield of a vfd pseudo- 
operation (see the section "The vfd Pseudo-Opera- 
tion" ) ; or 

3. It forms the variable field of a Type D or extended 
Type D machine instruction ( see Appendix A ) . 
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Relocatable symbols in a .Boolean expression are 

QTTnliinfnrj on 1^ l-\-i4- inj-prrovr nir»/-l iriffunl nrmnAio n t*o 

k; v cliuai^u cio j-c - i_/j.l jliilC^Cj. o anu v Ai. Liacij. oyliiuuio dii/ 

evaluated as zero. In either case, an error message is 
issued. 

In a Boolean expression, the four operators ( + , — , 
*, /) have Boolean rather than arithmetic meanings, 
as shown in the table. 



OPERATOR 


MEANING 


DEFINITION 


+ 


"inclusive or" ( also, 


+ = 




"union" ) 


+ 1 = 1 

1 + 0=1 

1+1=1 


- 


"exclusive or" ( also, 


0-0 = 




"symmetric differ- 


0-1 = 1 




ence" ) 


1-0 = 1 
1-1 = 


* 


"and" ( also, "inter- 


0*0 = 




section" ) 


0*1 = 
1*0 = 

1*1=1 


/ 


"complement" ( also, 


/0 = 1 




"not" or "ones' com- 


/1 = 



plement" ) 

The four Boolean operations are defined in the table 
for 1-bit quantities. The operation is extended to 18-bit 
quantities by handling each bit position independently. 

The following conventions also apply in using Bool- 
ean expressions : 

The / is a unary or one-term operator. The expres- 
sion a/b means /b, and the a is ignored. However, the 
presence of the a is not regarded as an error by the 
assembly program. The definitions of / in this case are: 

0/0 = 1 
0/1 = 
1/0 = 1 
1/1=0 

If the other operators ( + , — , * ) are used as unary 
operators, the definitions are as follows: 

+A=A+=A 

-A = 0-A,A-=A-0 

*A= error, A* = A*() = 

For the special case of the slash, the definition is: 

A/ = A/0=1 

In expressions where both terms are missing, defini- 
tions are as follows: 

+ =0 + = 000000 
-=0-0 = 000000 
* = Location counter 

7 = 0/0 = 777777 

In evaluating a Boolean expression, all integers are 
treated as 18-bit quantities. The operation / is per- 
formed first, followed by *, then by + and — . 

The operators +, — , and * may immediately pre- 
cede the slash in a Boolean expression. For example, 

A-/B 
is a valid Boolean expression. However, in no other 

permitted. 



Using Symbols in Expressions 

In map, ordinary symbols are not assigned values until 
a pass over the entire program has been completed. 
Therefore, there are no restrictions in the order of 
symbol definition. For example, 

ORG A 

A EQU 10000 

is a valid sequence in ibmap. 

Symbols in the variable field of pseudo-operations 
that affect location counters must be definable at as- 
sembly time. In the sequence 



BEGIN 


,A 


BSS 


B 


BES 


C 



A, B, and C may not be virtual symbols. (The org 
pseudo-operation is not subject to this restriction. ) The 
values of symbols B and C are always treated as 
constant. 

In general, any valid expression may appear in the 
variable field of machine instructions. In a relocatable 
assembly, final evaluation of complex arithmetic ex- 
pressions containing virtual symbols actually takes 
place at load time, when all symbols have been defined. 

Relative Addressing 

After an instruction has been named by the presence 
of a symbol in the name field, references to that in- 
struction can be made in other instructions by using 
the symbol. Instructions preceding or following the 
named instruction can also be referenced by indicating 
their position relative to the named instruction. This 
procedure is called relative addressing. A relative 
address is, effectively, a type of expression. For exam- 
ple, in the sequence 

ALPHA 



STGAM 



control may be transferred to the instruction cla 

IjAiVllVIA uy C1L11C1 Ui U1C lUHUWllig 111SL1 UCU1U1JS. 



TRA 


BETA 


CLA 


GAMMA 


SUB 


DELTA 


STO 


GAMMA 


TPL 


LOCI 



TRA 
TRA 



ALPHA +1 
STGAM -2 



It is also possible to use the asterisk ( * ) as an ele- 
ment in a relative aaaress. For example, in the 
sequence 



LOOP 



AXT 


10,1 


CLA 


A,l 


SUB 


B,l 


SUB 


C,l 


STO 


SUMJ 


TIX 


LOOP,U 


ion ir 


idicates a cone 



location loop. This could also be written 



:ix 



The address * — 4 is interpreted as "the location of 
this instruction minus 4." 

Relative addressing must be used carefully in com- 
bination with pseudo-operations, since some pseudo- 
operations may generate more than one word or no 
words in the object program. For example, the in- 
struction 

ALPHA OCT 2732,427,12716 

generates three words of octal data, with alpha as- 
signed to the address of the first word generated. Thus 



the address alpha + 2 refers to the third word gener- 
ated (12716). 

Reference can also be made to a word in a block of 
storage reserved by a bss or bes pseudo-operation by 
using relative addressing. For example, the instruction 

BETA BSS 50 

reserves a block of 50 words, where beta is assigned 
to the first word of the block. The address beta+ l refers 
to the second word, and beta + ji refers to the (n + 1 )st 
word. 
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Part ii. MAP Pseudo-Operations 



map provides the programmer with more than sixty 
pseudo-operations that can perform a variety of pro- 
gramming functions with greatly reduced program- 
ming effort. They have been grouped according to 
function, and the structure and purpose of most of the 
map pseudo-operations are described in this part of the 
publication. The macro-operation facility is covered 
separately in Part III. 



Location-Counter Pseudo-Operations 

Location counters enable instructions that are written 
in one sequence to be loaded in a different sequence. 
map enables a programmer to establish an indefinite 
number of location counters, which can be repre- 
sented by symbols of his choice. The symbol used to 
represent a location counter may duplicate any other 
symbol in the program except another location-counter 
symbol. 

The blank location counter, so called because it has 
no associated symbol, is the basic location counter. If 
the use pseudo-operation is not used, instructions are 
assembled under the blank location counter. In addi- 
tion, a location counter represented by two slashes 
( // ) is reserved for use with blank common. 

The USE Pseudo-Operation 

The use pseudo-operation places succeeding instruc- 
tions under control of the location counter represented 
by the symbol in the variable field. The format of the 
use pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


USE 


Either: 

1. A single symbol, or 

2. Blanks, or 

3. //, or 

4. The word PREVIOUS 



The location counter in control at the time of the 
use pseudo-operation is suspended at its current value. 
It is temporarily preserved as the "previous" counter. 
It continues from this value if it is reactivated by 
another use. If use with the word previous in the vari- 
able field is coded, the previous location counter is 
reactivated. For example, the effect of the sequence 



is identical to that ot 

USE A 

USE B 

USE A 

This option provides a means of returning to a 
location counter even if the counter symbol is not 
known. 

A use pseudo-operation with a blank variable field 
must precede the first instruction of the deck if the 
blank counter is set to a value other than zero by the 
operation 

BEGIN expression 

The sequence of location counters is: the blank 
counter first, the other symbolic counters in the order 
of their first appearance in a use or begin pseudo- 
operation, and finally the // counter. 

The BEGIN Pseudo-Operation 

The begin pseudo-operation specifies a location counter 
and establishes its initial value. The format of the 
begin pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


BEGIN 


Two subfields, separated by 
a comma: 

1. A location counter symbol, 

2. Any expression 



USE 


A 


USE 


B 


USE 


PREVIOUS 



The expression in the variable field may contain any 
symbol or constant. Relocatable symbols are given 
their assembly value, and this value becomes absolute. 
Control-section symbols are given a value of zero. 

The value of the second subfield of the variable field 
is used as the initial value for the location counter 
represented by the symbol in the first subfield. For 
example, the instruction 

BEGIN ALPHA,BETA 
would cause the instructions following 

USE ALPHA 

to be assembled beginning at location beta. 

If no begin is given for the blank location counter, its 
initial value is defined as ( absolute in an absolute 
assembly and relative in a relocatable assembly). If 
no begin is given for the nth location counter ( taken in 
location counter order ) , its initial value is given as the 
last value by the (n — I)st location counter. If more 
than one begin is given for a specific location counter, 
only the first one is used. Each of the others causes an 
error message to he issuer! and is minted as a com- 
ment, but is otherwise ignored. 
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A begin may appear anywhere in the program re- 
gardless of the location counter in control. 

Note that if the blank location counter is set to a 
value other than zero by the operation 

BEGIN , expression 

the use pseudo-operation with a blank variable field 
must precede the first instruction of the deck. 

The order in which location counters are used is 
illustrated in the example: 

instruction 1 

BEGIN A,* 

USE A 

instruction 2 

instruction 3 

BEGIN G* 

instruction 4 

instruction 5 

USE // 

instruction 6 

instruction 7 

USE B 

instruction 8 

instruction 9 

USE C 

instruction 10 

END 
In this sequence, instruction counters are used in the 
order: blank, A, C, B, and //. At load time, the se- 
quence of instructions will be: 

instruction 1 

instruction 2 

instruction 3 

instruction 10 (instruction 4 will be 

overlaid ) 

instruction 5 

instruction 8 

instruction 9 

instruction 6 

instruction 7 

The ORG Pseudo-Operation 

The org (Origin) pseudo-operation redefines the value 
of the current location counter. The format of the org 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


ORG 


Any expression 



The org pseudo-operation causes the current location 
counter to be reset to the value of the variable field. If 
there is a symbol in the name field, it is given this value. 

Absolute origins are permitted in a relocatable as- 
sembly. An origin is treated as absolute if the value of 
the variable field of the org pseudo-operation is con- 
stant. Thus, 

ORG 5000 

sets the location counter to 5000. In a relocatable as- 
sembly, references to symbols under the control of an 
absolute origin (org or begin) are absolute. 



For example, the location counter is set at the sixth 
location of the program by 

ORG START +5 

where start is the first location of the program. 

Storage-Allocation Pseudo-Operations 

The storage-allocation pseudo-operations reserve core 
storage areas within the sequence of the program. 

The BSS Pseudo-Operation 

The bss (Block Started by Symbol) pseudo-operation 
reserves a block of consecutive storage locations and 
may describe the data that will occupy the block. The 
format of the bss pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


BSS 


One or two subfields, 
separated by a comma: 

1. Any expression, 

2. Modal and dimensional 
information 



The bss pseudo-operation increases the value of the 
current location counter by the defined value of the 
expression in the first subfield of the variable field. 
The expression may contain any symbol or constant. 
Relocatable symbols are given their assembly value, 
and this value becomes absolute. Control-section sym- 
bols are given a value of zero. If there is a symbol in 
the name field, its defined value is that of the location 
counter just before the increase. 

When the second subfield is used, a symbol must 
appear in the name field. This subfield supplies modal 
and dimensional information to the debugging dic- 
tionary about the data that will occupy the block. The 
second subfield must be used if the symbol in the 
name field also appears in the variable field of a keep 
pseudo-operation or if the full debugging dictionary 
is specified in the variable field of a sibmap card. ( See 
the publications IBM 7090/7094 IBSYS Operating 
System: IBJOB Processor Debugging Package, Form 
C28-6362 and IBM 7090/7094 IBSYS Operating Sys- 
tem: IBJOB Processor, Form C28-6275.) The format 
for this subfield is : 

mode (di, d 2 , d 8 ) 
where d b d 2 , and d 3 are the dimensions, if any, of the 
array denoted by the symbol in the name field, and 
mode is one of the following: 

O Octal 

F Floating-point number 

X Fixed-point number 

D Double-precision floating-point number 

J Complex number 

L Logical 
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S Symbolic instruction 
C Symbolic command 
H Alphameric 

If an entry for mode is not one of the nine recognized 
letters above, the mode is assumed to be octal. If an 
entrv for dimension is not a decimal integer an error 
message is issued. 

When the second subfield is not used, it is assumed 
that the mode is octal and the dimension is 1. 

For example, in the sequence 



ALPHA 

BETA 

GAMMA 



IORD 

BSS 

IORD 



BETA„4 

4 

DELTA„6 



if alpha has been assigned to location 1001, both beta 
will be assigned to location 1002 and gamma to loca- 
tion 1006. Thus, four locations are reserved for an 
array whose first element is at location beta; and an 
entry, specifying that this array is one-dimensional 
and that its elements are octal numbers, is made into 
the debugging dictionary. 

In addition to reserving four locations, the instruc- 
tion 

BETA BSS 4,F(2,2) 

indicates to the debugging dictionary that the data to 
occupy this area is a 2 by 2 array of floating-point 
numbers. 

The area reserved by the bss pseudo-operation is 
not zeroed. 

The BES Pseudo-Operation 

The bes (Block Ended by Symbol) pseudo-operation 
also reserves a block of consecutive storage locations 
and may describe the data that will occupy the block. 
The format of the bes pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


BES 


One or two subfields, 
separated by a comma : 

1. Any expression, 

2. Modal information 



The expression in the first subfield of the variable 
field may contain any symbol or constant. Relocatable 
symbols are given their assembly value, and this value 
becomes absolute. Control-section symbols are given 
a value of zero. 

The bes pseudo-operation functions almost identi- 
cally to a bss pseudo-operation except that the symbol 
in the name field is defined after the location counter 
increases and thus refers to the first word following 
the reserved block. 

A symbol must appear in the name field of a bes 
pseudo-operation if the second subfield of the vari- 
able field is used. This subfield has the same use as it 
does in the bss except that it specifies modal informa- 



tion only. (If dimensional information is given, it is 
ignored, j Thus an entry m tue seeonu subueiu o± tue 
variable field of a bes instruction consists of one of the 
letters o, r, x, d, j, l, s, c, or n, as described in the 
discussion of the bss pseudo-operation. If the entry for 
mode is omitted or is a symbol other than the nine 
listed above, the mode is assumed to be octal. 
For example, in the sequence 



ALPHA 


IORD 


BETA„4 


BETA 


BES 


4 


GAMMA 


IORD 


DELTA„4 



if alpha has been assigned to location 1001, both beta 
and gamma will be assigned to location 1006 and four 
locations will be reserved for octal data. 

In addition to reserving four locations, the instruc- 
tion 

BETA BES 4,X 

supplies the debugging dictionary with the informa- 
tion that the data to occupy this area is in the fixed- 
point mode. 

The difference between bes and bss can be seen in 
the sequence of instructions 



ALPHA 



BES 
CLA 



25 
BETA 



which is effectively the same as 



BSS 
CLA 



25 
BETA 



ALPHA 

The area reserved by the bes pseudo-operation is not 
zeroed. 

The EVEN Pseudo-Operation 

The even pseudo-operation forces the current location 
counter to an even value to ensure an even address for 
the next instruction or data— usually a double-precision 
floating-point number. It is used only in the 7094 and 
has no effect in the 7090 or 7094 n. The format of the 
even pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


EVEN 


Ignored 



In a 7094 relocatable assembly, the even pseudo- 
operation causes the instruction 

AXT 0,0 

to be inserted at load time if the load address of the 
axt instruction is not even. The axt instruction has no 
other effect on the program. 

In a 7094 absolute assembly, the even pseudo- 
operation causes the insertion of the instruction 

AXT 0,0 

at assembly time so that it is available at load time in 
the event that the axt instruction load address is not 



even, xne aai iiiau ucuun una uu uuici ciicci uu uic 



program. 
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The LORG Pseudo-Operation 

The lorg (Literal Pool Origin) pseudo-operation 
places the Literal Pool in the program at die point 
where lorg occurs. The format of the lorg pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


LORG 


Ignored 



A symbol in the name field is assigned to the first 
location of the Literal Pool (see the section "Literals"). 
If no lorg is given, the Literal Pool origin is one be- 
yond the final value of the location counter in use at 
the end of the program. If more than one location 
counter has been used, lorg can be used to prevent 
the Literal Pool from overlapping part of the program. 
For example, in the sequence 





USE 


Y 


A 


BSS 


1 




USE 


X 


B 


CLA 


= 1 




USE 


Y 




END 





the Literal Pool would be placed at symbolic location 
B ( one beyond the final value of location counter Y ) . 

If more than one lorg is given, only the first is 
effective. If the // location counter is used, caution 
must be used in locating the Literal Pool. 

An even pseudo-operation should precede lorg if 
double-precision literals are used in 7094 programs to 
ensure their entry at an even address. 

The LDIR Pseudo-Operation 

The Lorn (Linkage Director) pseudo-operation places 
the Linkage Director in the program at the point of 
the ldir. The format of the ldir pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


LDIR 


Ignored 



The Linkage Director is a unique location for each 
assembly, which is one beyond the final value of the 
location counter if the ldir pseudo-operation is not 
used. If the ldir pseudo-operation is used with a sym- 
bol in the name field, the programmer may refer to the 
Linkage Director. 

The Linkage Director serves as a cross-reference for 
the call and save pseudo-operations. If neither the 
ldir nor lorg pseudo-operations is used, the Linkage 
Director precedes the Literal Pool. If the ldir pseudo- 
operation appears more than once, only its first appear- 
ance is effective. 



For example, 

ALPHA LDIR 

would cause 

ALPHA PZE 

BCI l,deckname 

to be generated. The second subfield in the bci opera- 
tion is the deckname specified on the $ibmap card ( see 
the publication IBM 7090/7094 IBSYS Operating Sys- 
tem: IBJOB Processor, Form C28-6275). 

The COMMON Pseudo-Operation 

The common pseudo-operation has been preserved 
solely for compatibility with existing programs. It re- 
serves an area called blank common for use in common 
with such programs. The format of the common 
pseudo-operation is: 



NAME FD2LD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


COMMON 


One or two subfields separated 
by a comma: 

1. Any expression 

2. Modal and dimensional in- 
formation 



The first subfield of the variable field may contain 
any symbol or constant. Relocatable symbols are given 
their assembly value, and this value becomes absolute. 
Control-section symbols are given a value of zero. 

The common operation causes: 

1. Location counter // to be activated 

2. A symbol in the name field, if any, to be defined 
as having the current value of location counter // 

3. Location counter // to be increased by the defined 
value of the variable field expression 

4. The location counter in use prior to the common 
operation to be reactivated 

The effect of the sequence 
A COMMON E 

is equivalent to 



A 



The second subfield of the variable field is used in the 
same way as the second subfield of the bss pseudo- 
operation. (See "bss Pseudo-Operation.") 

Data-Generating Pseudo-Operations 

Five pseudo-operations (oct, dec, bci, lit, and vfd) 
provide the programmer with a convenient means of 
introducing data expressed in a variety of forms into a 
program during assembly. Numbers introduced by 
these operations are often referred to as constants. A 
sixth pseudo-operation, dup, permits a sequence of sym- 
bolic cards to be duplicated a specified number of 
times. 



USE 


// 


BSS 


E 


USE 


PREVIOUS 
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The OCT Pseudo-Operation 

The oct (Octal Data) pseudo-operation introduces 
binary data expressed in octal form into a program. 
The format of the oct pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


OCT 


1. One or more octal inte- 
gers, separated by com- 
mas, or 

2. Blanks 



Each subfield in the variable field contains a signed 
or an unsigned octal integer of n digits, where n ^ 12. 
The only limit on the number of subfields is that they 
must all be contained in the variable field of one card. 

A blank variable field results in a word of all zeros. 

The oct operation converts each subfield to a binary 
word. These words are assigned to successively higher 
storage locations as the variable field is processed 
from left to right. If a symbol is used in the name field, 
it is assigned to the first word of data generated. 

For example, each of the instructions 



ALPHA 


OCT 


777777777777 


ALPHA 


OCT 


-777777777777 


ALPHA 


OCT 


-377777777777 



would result in a binary word of 36 consecutive ones 
at location alpha. 

In the instruction, 

ALPHA OCT 43,25,64 

the binary equivalent of octal number 43 would appear 
at location alpha, the binary equivalent of 25 at loca- 
tion alpha +i, and the binary equivalent of 64 at 
alpha +2. 



The DEC Pseudo-Operation 

The dec ( Decimal Data ) pseudo-operation introduces 
data expressed as decimal numbers into a program. 
The format of the dec pseudo-operation is : 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


1. A symbol, or 


DEC 


1. One or more decimal data 


2. Blanks 




items, separated by com- 
mas, or 
2. Blanks 



The only limit on the number of subfields is that 
they must all be contained in the variable field of one 
card. 

A blank variable field results in a word of all zeros. 

The dec operation converts each subfield to one or 
two binary words, depending on whether the decimal 

"I . ■. ■ ■ .1 lit • • ml T 

uaici iieiii is suigie or uoUDie precision, xiicse woius 
are stored in successively higher storage locations as 



the variable field is processed from left to right. A 
v„i i .-- j.l„ _„ c~u -~ — ;~ — j j-~ *i-~ c — *■ 

aymuui uscu in uic name nCiu. is ctssigncu. iu 111c inai 

word of data generated. 

For example, the instruction 

ALPHA DEC 43,25 






s\J U.1 V CU.V>11L \J± Vl^WllllCtJ. 



ber 43 appearing at location alpha and of decimal 
number 25 appearing at location alpha +i. 

The BCI Pseudo-Operation 

The bci (Binary Coded Information) pseudo-operation 
introduces binary-coded decimal data into a program. 
Each data word generated consists of six 6-bit char- 
acters in standard bcd code. The format of the bci 
pseudo-operation is : 





OPERATION 




NAME FIELD 


FIELD 


VARIARLE FIELD 


1. A symbol, or 


BCI 


Two subfields, separated by 


2. Blanks 




a comma: 

1. Single-digit count or 
symbol, 

2. Alphameric data 



If a digit is used in the count subfield, it must be a 
single digit from 1 through 9. 

A null subfield indicates a count of ten. To accommo- 
date the full ten words of data on the card, the null 
subfield must be indicated by a comma in column 12. 

The data subfield contains any desired alphameric 
information (see Appendix E for the map bcd char- 
acter code). 

The length of the data subfield is determined by the 
number of six-character words specified in the count 
subfield. The immediate value of the symbol used in 
this subfield may also be used to determine the length 
of the data subfield. 

The comments field begins immediately after the 
end of the data subfield, and no blank character is 
needed to separate the data subfield from the com- 
ments field. Any part of the data extending beyond 
the limit of the data field is treated as comments. Blanks 
are inserted as required to fill the data subfield to the 
length specified by the count subfield. 

Thus, the bci pseudo-operation introduces data 
words into consecutive locations, the number of words 
generated being equal to the number in the count 
subfield. A symbol used in the name field is assigned 
to the first word of data generated. 



For example, 



ALPHA 



BCI 



2,bPROFITbRISEbINbPER- 
CENT 



wouici generate uie aala woius profit rise, "wiieieas 
in percent would be comments. 
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The VFD Pseudo-Operation 

Each vfd pseudo-operation generates no, one, or more 
than one binary data words and assigns them to suc- 
cessively higher storage locations. The format of the 
vfd (Variable Field Definition) pseudo-operation is: 



NAME FIELD 


OPEBATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


VFD 


Any number of subfields, 
separated by commas 



Each subfield of the variable field generates zero, one, 
or more than one bits of data. Thus, the unit of informa- 
tion for this pseudo-operation is the single bit. 

Each subfield may be any one of three types: octal 
(Boolean), alphameric, or symbolic (including deci- 
mal integers). 

The subfield of the vfd pseudo-operation consists of: 

1. The type letter 

a. The letter O signifies an octal (Boolean) field. 

b. The letter H signifies an alphameric field. 

c. The absence of either O or H signifies a sym- 
bolic or decimal field. 

2. The bit count 

Either a decimal integer or an immediate symbol 
specifies the number of bits to be generated by the 
subfield. If an immediate symbol is used, care should 
be taken to avoid confusion caused by the type letter. 
The maximum allowable bit count for a single subfield 
is 864. 

3. The separation character slash (/) 

4. The data item 

a. In an octal subfield, the data item is one 
Boolean expression. 

b. In an alphameric subfield, the data item is a 
string of characters none of which is a comma 
or a blank. 

c. In a symbolic subfield, the data item is one 
expression. A maximum of 20 significant bits 
are obtainable in a symbolic subfield. 

Any number of subfields may be used. Successive 
subfields of the variable field are converted and packed 
to the left to form generated data words. If n is the bit 
count of the first subfield, the data item in that sub- 
field is converted to an n-bit binary number that is 
placed in the leftmost n positions of the first data word 
to be generated. If n exceeds 36, the leftmost 36 bits 
of the converted data item form the first generated 
data word and the remaining bits are placed in the 
first (n — 36) bit positions of the second generated data 
word. 

Each succeeding subfield is converted and placed 
in the leftmost bit positions remaining after the pre- 
ceding subfield has been processed. If the total number 
of bit positions used is not a multiple of 36, the unused 



bit positions at the right of the last generated data 
word are filled with zeros. 

If the data item is a single signed octal integer of 
any length, the sign is recorded as the high-order bit 
of the specified bit group. 

If after conversion a symbolic or octal item occupies 
more than n bits, only the rightmost n bits of the con- 
verted data item are used. If the converted data item 
occupies fewer than n bits, enough zero bits are placed 
at the left of the converted data item to form an n-bit 
binary number. Neither condition is regarded as an 
error by the assembly program. 

The data item in a symbolic subfield is converted 
as a symbolic expression. Decimal integers must not 
exceed 32767. 

The data item in an octal subfield may be any valid 
Boolean expression. A single signed or unsigned octal 
integer is a valid Boolean expression, which, in this 
case, may exceed 18 bits. 

The data item in an alphameric subfield may consist 
of any combination of characters other than a comma 
or a blank. Each character is converted to its 6-bit 
binary code equivalent. If the converted data item 
occupies more than n bits, only the rightmost n bits 
are used. If the converted data item occupies fewer 
than n bits, sufficient 6-bit groups of the form 110000 
( the bcd code for blank ) are placed at the left of the 
converted data item to form an n-bit binary number. If 
n is not a multiple of 6, the leftmost character or blank 
is truncated. None of these conditions is regarded as 
an assembly error. 

For example, the vfd pseudo-operation could be 
used to break up a 36-bit word as follows: Positions S 
and 1 through 9 must contain the binary equivalent of 
the decimal integer 895, positions 10 through 14 must 
contain the binary equivalent of the octal integer 37, 
positions 15 through 20 must contain the binary equiv- 
alent of the character C, and positions 21 through 35 
must contain the value of the symbol alpha. The in- 
struction to generate this word is 



VFD 



10/895,O5/37,H6/C, 15/ALPHA 



The LIT Pseudo-Operation 

The lit (Literal) pseudo-operation places data items 
from the subfields of the variable field into the Literal 
Pool in successively higher storage locations. 
The format of the lit pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


LIT 


Data subfields, separated by 
commas 



Rules for the contents of the data subfields are the 
same as those governing literals except that the equal 
sign ( = ) is omitted. 
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A Literal .Fool entry made using a lit pseuao-opera- 

field generates only two consecutive words of data. If 
a double-precision entry is made in the Literal Pool 
by either a lit pseudo-operation or a double-precision 
literal, the number is placed in an even location rela- 
tive to the beginning of the Literal Pool. (In this re- 
spect, the assembly program does not distinguish 
double-precision floating-point numbers from double- 
precision fixed-point numbers. ) 

For example, 

LIT 1,2 

causes the number 1 to be placed in an even location 
relative to the beginning of the Literal Pool (which 
can result in duplicate entries in the Literal Pool ) . 

The instruction 

LIT 1EE1 

results in a double-precision entry beginning in an 
even location in the Literal Pool, but the instruction 

LIT 1EE1,2 

results in a three-word entry with the first word not 
necessarily entered into an even location. 

Thus, double-precision floating-point numbers may 
be used as constants if an even pseudo-operation is 
used immediately preceding the lorg operation or, if 
no lorg is present, immediately before the end pseudo- 
operation. 



The DUP Pseudo-Operation 

The dup (Duplicate) pseudo-operation causes an in- 
struction or sequence of instructions to be duplicated. 
An important application is in generating tables. The 
format of the dup pseudo-operation is; 



field of the symDoiic cam is uupricatea. ; ah iteration 

pnimt of 7Prn oaiicpij thp fntirp ran^f to be omitted. 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


1. A symbol, or 


DUP 


Two subfields, separated by 


2. Blanks 




a comma: 

1. An expression 

2. An expression 



The first subfield represents instruction count, and 
the second subfield represents iteration count. Integers 
are generally used in these subfields. Symbols in the 
instruction count and iteration count subfields are 
evaluated for their S-values. 

If m represents instruction count and n represents 
iteration count, the dup pseudo-operation has the effect 
of duplicating the next m instructions n times. 

The group of m instructions following the dup es- 
tablish the range of the dup. The effect of the dup 
pseudo-operation is that the set of m symbolic cards 



For example, the sequence 



DUP 


2,3 


PZE 


X 


PZE 


Y 


PZE 


X 


PZE 


Y 


PZE 


X 


PZE 


Y 


PZE 


X 


PZE 


Y 



With the sole exception of the end pseudo-operation, 
any operation may appear within the range of a dup, 
including another dup. 

If a dup pseudo-operation occurs within the range 
of a preceding dup, the two (or more) dup pseudo- 
operations are said to be nested. As in most cases of 
nesting, the effect of nested dup pseudo-operations must 
be determined beginning with the innermost one and 
working out. If the explicit range (the instruction 
count) of the inner dup extends beyond the range of 
an outer dup, the implicit range of the outer dup is 
extended to the farthest point covered by the inner 
dup. The first card to be processed after such a series 
of dup pseudo-operations is the next card beyond both 
explicit and implicit dup ranges. 

For example, the operation 
DUP m,n 

duplicates the effect of the next m cards n times. 

In the nested dup pseudo-operations in the sequence 



DUP 


1,2 


DUP 


1,2 


PZE 


X 


PZE 


z 



the single card to be duplicated by the outer dup is the 
inner dup, and the effect of the inner dup is actually the 
two operations 

PZE X 

PZE X 

The sequence generated when the outer dup is ex- 
panded is 

PZE X 

PZE X 

PZE X 

FZE X 

PZE Z 

where the last card in the sequence is the first card 
beyond both the explicit and implicit ranges of the 
outer dup. 

In the sequence 



~,~l,-~>~, — a,. 









the symbolic deck behind the original set. ( The name 



DUP 


3,2 


DUP 


1,2 


PZE 


X 


?££, 


I 


PZE 


z 
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the effect of the three cards following the outer dup is 
actually the four operations 



When the outer dup is expanded, the resulting sequence 
is 



PZE 


X 


PZE 


X 


PZE 


X 


PZE 


Y 


dup is exp 


and 


PZE 


X 


PZE 


X 


PZE 


X 


PZE 


Y 


PZE 


X 


PZE 


X 


PZE 


X 


PZE 


Y 


PZE 


Z 



where the last symbolic card is the first card beyond 
the explicit range of the outer dup. 

The range of a dup that occurs within the range of 
another dup must be fixed before the outer dup is en- 
countered. This can be done by using the set pseudo- 
operation. (See the section "The set Pseudo- 
Operation.") For example, the sequence 



SET 


1 


DUP 


2,2 


SET 


K + l 


DUP 


K,n 



will result in an error message and assembly will be 
terminated. However, the iteration count may be vari- 
able. For example, the sequence 



K SET 


1 


DUP 


2,2 


K SET 


K+l 


DUP 


m,K 


is valid and will be assembled < 


the sequence 




K SET 


1 


DUP 


2,2 


K SET 


K + l 


DUP 


3,K 


PZE 


X 


PZE 


Y 


PZE 


Z 


would result in 




PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 


PZE 


X 


PZE 


Y 


PZE 


Z 



Symbol-Defining Pseudo-Operations 

map provides a group of pseudo-operations specifically 
designed to define the symbols that appear in their 
name fields. They are useful in a variety of program- 
ming applications, such as equating symbols to com- 
bine separately written program segments or changing 
parameters referred to symbolically throughout a pro- 
gram by redefining the symbol. 

The EQU and SYN Pseudo-Operations 

The equ and syn pseudo-operations are identical. The 
format of the equ and syn pseudo-operations is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


EQU 

or 
SYN 


One or two subfields, 
separated by a comma: 

1. Any expression, 

2. Modal and dimensional 
information 



The equ and syn pseudo-operations give the name 
field symbol the same definition — and the same struc- 
ture — as the expression in the first subfield of the 
variable field. Thus, if A is defined as X + Y — Z and 
the instruction 

B EQU A 

is given, B is defined as X + Y — Z. The instruction 

LCS EQU * 

defines lcs as having the current value of the location 
counter. 

When the second subfield is used, it supplies to the 
debugging dictionary modal and dimensional informa- 
tion about the symbol in the name field. This sub- 
field must be used if the symbol in the name field 
also appears in the variable field of a keep pseudo- 
operation. (See the publication IBM 7090/7094 IBSYS 
Operating System: IBJOB Debugging Package, Form 
C28-6362.) The format for this entry is 

mode (di, d 2 , d 3 ) 
where di, d 2 , and d3 are the dimensions, if any, of the 
array denoted by the symbol in the name field, and 
mode is one of the letters o, f, x, d, j, l, s, c, or h, as 
explained in the discussion of the bss pseudo-opera- 
tion. 

If the mode is omitted or is a symbol other than the 
nine listed above, it is assumed to be octal. Dimensions 
must be decimal integers or an error message is issued. 

The NULL Pseudo-Operation 

The format of the null pseudo-operation is: 



The variable field of a dup pseudo-operation cannot be 
extended by use of the etc pseudo-operation. 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


NULL 


Ignored 
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The null pseudo-operation defines the symbol in the 
name field, if any, as having the current value of the 
location counter. The operation 

LCS NULL 

is equivalent to 

LCS EQO * 

except that null is preferred. 

The MAX Pseudo-Operation 

The max pseudo-operation gives the symbol in the 
name field an absolute value equal to the expression 
in the variable field that has the maximum defined 
value. The format of the max pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


MAX 


Expressions, separated by 
commas 



The maximum value is computed as if all symbols were 
absolute. The comparison is made after negative values 
have been complemented. For example, the sequence 



A 
ALPHA 



BSS 

MAX 

EQU 



is equivalent to 



BSS 



100,ALPHA,ALPHA- 100 
150 



150 



The MIN Pseudo-Operation 

The effect of the min pseudo-operation is opposite to 
that of max. The symbol in the name field is given an 
absolute value equal to the expression in the variable 
field having the minimum defined value. The format 
of the min pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


MIN 


Expressions, separated by 
commas 



The minimum value is computed as if all symbols were 
absolute. The comparison is made after negative values 
have been complemented. For example, the sequence 



A 
ALPHA 



BSS 

MIN 
EQU 



100,ALPHA,ALPHA- 100 
150 



is equivalent to 



BSS 



The SET Pseudo-Operation 

The set pseudo-operation causes the symbol in the 
name field to be defined immediately. The set pseudo- 
operation, which can be used to define symbols in both 
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dup, vfd, ift, and iff pseudo-operations. The format 
oi tne set pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


SET 


Any expression 



Qualified symbols may not be used in the variable field. 

The symbol in the name field is immediately assigned 
the value ( called the S-value ) of the variable field ex- 
pression during the first pass of the assembly program. 
Thus, the set pseudo-operation enables the program- 
mer to use sequences of instructions in which decisions 
depend on the value assigned to a symbol during the 
first pass of the assembly program. It also permits sym- 
bols to be redefined repetitively. The value assigned 
to the symbol is always a 15-bit integer. 

Use of the set pseudo-operation is subject to the 
following conditions: 

1. Immediate symbols may not be qualified. 

2. An immediate symbol used in the variable field 
of a pseudo-operation affecting location counters ( such 
as bss) assumes the final value assigned to it in the 
program. For example, the sequence 



A SET 


100 


BSS 


A 


A SET 


1000 


END 




is equivalent to 





BSS 1000 

3. An immediate symbol should not normally be 
given a name identical to an ordinary symbol, since 
doing so can result in multiple definition. 

An example of the use of the set pseudo-operation 
to assign a value to a symbol during the first pass of 
the assembly program is shown in the following se- 
quence. 



ALPHA 



SET 
VFD 



50 
ALPHA/BETA 



By using the set pseudo-operation, the value of 
alpha can be changed without altering the vfd in- 
struction. A similar use of immediate symbols is in 
making conditional assembly decisions with the iff/ift 
pseudo-operations. 

The set pseudo-operation permits a symbol to be re- 
defined repeatedly for such programming functions as 
constructing tables and writing macro-operations. For 
example, in the sequence 



ALPHA 



SET 
DUP 
PZE 
SET 



1 

2,9 

ALPHA 
ALPHA +1 



ALPHA 
alpha is first assigned a value of 1 and then redefined 



iiiiy^ m 
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used to define the symbols in the variable fields of the iteration. 
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Boolean Pseudo-Operations 

The Boolean pseudo-operations define symbols as 
Boolean quantities. 

The BOOL Pseudo-Operation 

The bool (Undesignated Boolean) pseudo-operation 
functions like the equ pseudo-operation except that the 
variable field expression is Boolean and the name field 
symbol becomes a Boolean symbol. The format of the 
bool pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


BOOL 


A Boolean expression 



bool defines the symbol in the name field as an 18-bit 
constant. Relocatable symbols or virtual symbols used 
in the variable field result in an error. Octal integers 
in the variable field may not exceed six characters. 



The RBOOL and LBOOL Pseudo-Operations 

The format of the bbool ( Right Boolean ) and lbool 
(Left Boolean) pseudo-operations is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


RBOOL 

or 
LBOOL 


A Boolean expression 



Relocatable symbols or virtual symbols used in the 
variable field result in an error. Octal integers in the 
variable field may not exceed six characters. 

These pseudo-operations are similar to bool except 
that the symbol in the name field is defined as right 
(left) Boolean. They are normally used to determine 
the correct machine operation for the special type D 
instructions (sib, bnt, bft, iib, and rib). The following 
mechanism is used. 

1. If the expression in the variable field of an sib 
instruction is entirely left ( right ) Boolean, the instruc- 
tion is assembled as sil ( sir ) . Constants are considered 
to be both left and right Boolean. If the expression is a 
mixture of both left and right Boolean, sil is assembled 
but a warning message is issued. 

2. If the variable field of an sil (sir) instruction is 
not purely left (right) Boolean, left (right) and un- 
designated Boolean, or purely undesignated Boolean, 
a warning message is issued. 

For example, following the instructions 



the instruction 






BFT 


X 


assembles as LFT 123 


BNT 


Y 


assembles as RNT 456 


IIB 


Z 


assembles as II R 321 


RIB 


Y+Z 


assembles as RIR 777 


SIB 


Y+Z 


assembles as SIL 323 



A warning message is issued for the last instruction 
(sib) because of the mixture of left and right Boolean. 



Conditional-Assembly Pseudo-Operations 

Two pseudo-operations provided by map enable the 
programmer to specify that the next instruction is to 
be assembled only if certain criteria are met. Another 
pseudo-operation, goto, may be used with the condi- 
tional-assembly pseudo-operations to extend their 
effect over more than one instruction. 

The IFT and IFF Pseudo-Operations 

The ift ( If True ) and iff ( If False ) pseudo-operations 
specify conditions that determine whether the next 
sequential instruction will be assembled. The format 
of the ift and iff pseudo-operations is: 





OPERATION 




NAME FIELD 


FIELD 


VARIABLE FIELD 


Blanks 


IFT 


1 . Element— relational opera- 




or 


tor—element 




IFF 


2. If present, either of the 
words OR or AND, pre- 
ceded by a comma 



X 


LBOOL 


123 


Y 


RBOOL 


456 


Z 


RBOOL 


321 



The ift (iff) pseudo-operation assembles the next 
instruction if the condition expressed by the operation 
and the first subfield is met. 

A relational operator consists of one or two adjacent 
symbols signifying: 

= Equals 

= + Greater than 

= — Less than 

The elements at the left and right of these relations 
must not be qualified. The element is used in one of 
two ways: 

1. To represent a numerical value equal to its S-value 

2. To represent literal bcd information, in which case 
it is surrounded by slash ( / ) marks 

Interpretation of the relational operator depends on 
the context. If the elements represent bcd, the relation 
is a scientific collating sequence comparison. For ex- 
ample, 

IFT /A/= + /B/ 

is false and would therefore not permit assembly of the 
next instruction. However, 

IFT /A/=-/B/ 

is true and would permit assembly of the next instruc- 
tion. 
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IFF // = /A/ 

compares blank to A and would permit assembly of 
the next instruction. 

If the elements represent a numeric quantity, the re- 
lation is a numeric comparison. The programmer must 
avoid noncomparable elements. 

Presence of the second subfield signifies that another 
ift or iff is to follow, in which case the combined effect 
of the two is either a logical or or a logical and. 

The S-value and not the definition is used in numeric 
evaluation of symbols. The set pseudo-operation may 
be used to control iff or ift pseudo-operations, as in 
the sequence 



K 



SET 
IFT 



4 
K = 4 



This statement is true, and the next instruction will be 
assembled. 

The fact that the conditional assembly extends over 
only one instruction is not a serious restriction, since 
the following instruction may be another ift or iff 
pseudo-operation, a goto pseudo-operation, or a 
macro-operation that expands to any length (see the 
section "Conditional Assembly in Macro-Operations"). 

The variable field of an iff or ift pseudo-operation 
may not be extended by using the etc pseudo-opera- 
tion. 

The GOTO Pseudo-Operation 

The goto pseudo-operation, when used with an ift 
or iff pseudo-operation, provides the map programmer 
with a method for either assembling or skipping 
blocks of instructions. The format of the goto pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


GOTO 


One or two subfields, 
separated by a comma : 

1. Symbol, which may be 
followed by a comma when 
used alone, 

2. The word BLANK, which 
may be followed by a comma 



The goto pseudo-operation causes all instructions 
following it, up to but not including the instruction 
whose name field contains the symbol specified in the 
variable field of this pseudo-operation, to be skipped 
during assembly. 

If the blank option is present, the symbol in the 
variable field will not be entered into the dictionary 
but will appear on the listing. Therefore, the symbol, 
which may be completely numeric, may be reused. 

Tf the variable field does not end with a comma, the 
skipped instructions are listed as comments. If the 
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structions is suppressed. 
For example, the sequence 



CLA 
IFT 
GOTO 
STO 



CLA 

TSX 



X 

A=l 
LCS 
Z 



B 

SUB,4 



LCS 
would produce 

LCS 
if A had previously been defined as 1, and 



CLA 
TSX 



X 

SUB,4 



CLA 
STO' 



CLA B 

LCS TSX SUB,4 

if A had been defined as some value other than 1. 

In this example, the instructions omitted would be 
listed and lcs would be entered into the dictionary. 
Alternate forms would be 



GOTO LCS,BLANK 
GOTO LCS, 
GOTO LCS.BLANK 



( LCS not entered, cards listed ' 
( LCS entered, no list ) 
( LCS not entered, no list ) 



If a goto occurs within a macro-definition and the 
referenced symbol is outside the definition, only the 
instructions between the goto and the endm pseudo- 
operation are skipped. If a goto references past an 
irp pseudo-operation, only the instructions between 
the goto and the irp are skipped. 



Symbol-Qualifying Pseudo-Operations 

map provides two pseudo-operations, qual and endq, 
that enable a programmer to qualify symbols within 
sections of a program. 



The QUAL Pseudo-Operation 

All symbols between the qual pseudo-operation and 
its associated endq pseudo-operation are qualified. The 
format of the qual pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


QUAL 


Symbol 



The symbol in the variable field qualifies all symbols 
defined within the section controlled by the qual pseudo- 
operation. References to a symbol defined in a qualified 
section from within the same section need not be qual- 
ified, Reference*: from outside the section 9Ve Qualified 
by placing the section symbol (variable field symbol 
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of the qual pseudo-operation ) in front of a connecting 
dollar sign followed by the desired symbol. For ex- 
ample, the symbol qssalpha refers to symbol alpha 
defined in qualified section qs. The notation sbeta re- 
fers to symbol beta, which is not qualified. The un- 
qualified section effectively has a blank qualifier. 

Qualified sections may be nested to provide multiple 
qualification. The range ( from a qual to its correspond- 
ing endq) of a lower-level qual must fall completely 
within the range of the next higher qual. A symbol is 
automatically qualified by any qualifiers of a higher 
level than the highest one specified in using the symbol. 
A multiply qualified symbol can be referenced without 
using all the qualifiers if enough qualifiers are given 
to determine the symbol uniquely. In any case, the 
qualifiers must be specified in the same order that nest- 
ing occurs within that section. 

A sequence illustrating qualification is 



QUAL 

BSS 

CLA 

ENDQ 

QUAL 

BSS 

ENDQ 



Qualified 
Section H 

Qualified 
Section J 



In this case, if X is written as A or h$a, it refers to 
the first definition of A; X written as jsa refers to the 
second definition of A. 

In the sequence of nested qualification 



QUAL 


M 




\ 


BSS 


1 




j 


QUAL 


N J 


Qualified 


f Qualified 


CLA 


X 


Section 


/ Section M 


ENDQ 


N ( 


M$N 


\ 


ENDQ 


M 




/ 


BSS 


1 






CLA 


Y 







X written as A refers to the first definition of A; X 
written as $a refers to the second nonqualified A. 
Y written as A refers to the second A; Y written as 
msa refers to the first A. 
In the more complicated sequence 





QUAL 


ONE \ 




A 


BSS 


1 




A 


QUAL 
BSS 
CLA 
ENDQ 


TW°) Qualified ( 
Y > Section 

T \ vo jONE$TWO 1 


' Quali- 
fied 
Section 

j ONE 




CLA 


Y 






ENDQ 


ONE 1 






QUAL 


THREE 




A 


BSS 


1 


1 Quali- 




QUAL 


TWO i Qualified 


> fied 


A 


BSS 


1 > Section 


Section 




ENDQ 


TWO \ THREE$TWO 


| THREE 




ENDQ 


THREE I 





X refers to the first A by ones a ; to the second A by A, 
by twosa, or by onestwosa; to the third A by threesa; 
and to the fourth A by threestwosa. 



Y refers to the first A by A or by onesa; to the second 
A by twosa or by onestwosa; to the third A by 
threesa; and to the fourth A by threestwosa. In this 
sequence, the two sections two are distinct and not 
separate parts of the same section. The first is section 
onestwo, and the second is section threestwo. 

The ENDQ Pseudo-Operation 

The format of the endq pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ENDQ 


Either: 

1. A symbol, or 

2. Blanks 



endq delimits the range of the qualified section 
whose symbol is in the variable field of this instruction. 
If the variable field is blank, the innermost qualified 
section is terminated. However, a low-severity warning 
message is issued, since a variable field inadvertently 
left blank can result in errors when using nested quali- 
fication. 

In nested qualified sections, a separate endq is re- 
quired to terminate each qualified section. Also, quali- 
fied sections must be terminated in order beginning 
with the lowest level section as shown in the following 
sequence, or an error message will be issued. 

QUAL ALPHA 



QUAL 



QUAL 



BETA 



GAMMA 



ENDQ GAMMA 



ENDQ 



ENDQ 



BETA 



ALPHA 



Control-Section Pseudo-Operations 

Relocatable programs can be divided into segments. 
By dividing large programs into relocatable segments, 
individual segments can be coded and checked in 
parallel, with consequent savings in time. Also, a seg- 
ment can be modified without requiring reassembly of 
the entire program. 

The control-section pseudo-operations provide the 
means for making references to and from such seg- 
ments, ibldr makes the cross-references among pro- 
gram segments that are assembled separately but 
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publication IBM 7090/7094 JBSYS Operating System: 
IB JOB Processor, Form C28-6275. ) 

Each program segment is a control section. In addi- 
tion, sections within segments may be designated as 
control sections by the programmer. 

ibldr treats control sections as being variable. A 
control section may be replaced by another control 
section or even deleted entirely. If more than one 
control section is given the same designation, generally 
only the first control section is retained. 

An even appearing within a control section must 
have the same relative location as the beginning of 
the control section. This will result in the first loca- 
tion of the control section being assigned an even 
location at load time. Thus, an instruction or data 
within a control section will be assigned to an even 
location if it appears an even distance from the con- 
trol section origin. 

The CONTRL Pseudo-Operation 

The contrl pseudo-operation designates a program or 
a part of a program as a control section. The format of 
the contrl pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


CONTRL 


One of the following: 

1. A location counter sym- 
bol, or 

2. A qualification symbol, or 

3. Two subfields, separated 
by a comma, each contain- 
ing an ordinary symbol 



The contrl pseudo-operation delimits the control 
section named in the name field in accordance with 
the contents of the variable field. If a location-counter 
symbol is used in the variable field, all instructions 
under control of the specified location counter are 
delimited. The blank location counter cannot be used 
as a control section. If a qualification symbol is used, 
all instructions between the specified qual pseudo- 
operation and its associated endq pseudo-operation are 
delimited. If two subfields are used, all instructions are 
delimited beginning at the location specified by the 
first symbol and ending at, but not including, the lo- 
cation specified by the second symbol, contrl pseudo- 
operations that refer to absolute symbols, or to loca- 
tion symbols whose definitions depend on an absolute 
origin within a relocatable assembly, are discarded 
and an error message is issued. An error message will 
also be given if a qualification symbol or location 
counter symbol defining a control section falls under 
an absolute origin. If the absolute origin occurs within 
the control section, no diagnostic will be given and 
relocation errors may occur during loading. 

If there is no symbol in the name field, the first sym- 
bol in the variable field is taken as the external name 



Qi tiie coniroi section anu a low-seventy message is 
issued. The length of a control section is alwavs the 
difference between the value of the location counter in 
control at the end of the section and its value at the 
beginning of the section. Hence, the use of org or use 
pseudo-operations within control sections may result 
in incorrect length calculations, in effect, "losing" in- 
structions from the section. The contrl pseudo-opera- 
tion may appear anywhere in the program. In an abso- 
lute assembly, a low-severity error message is printed, 
but contrl is otherwise ignored. For example, 

X CONTRL A,B 

defines the portion of the program from A to, but not 
including, B as control section X. 

Control sections may be nested. 

To obtain the blank common area, as used by 7090/ 
7094 Fortran iv, an instruction of the form 

CONTRL // 
must be used. For example, in the sequence 



CONTRL 
USE 



USE 



// 
A 



USE 


// 


BSS 


20 


USE 


C 



USE 



END 



the blank common counter // will have its initial lo- 
cation defined as the last value reached by location 
counter C. The area under control of the // counter is 
a control section. 

The ENTRY Pseudo-Operation 

The entry pseudo-operation provides a reference from 
outside a program segment to a point within the pro- 
gram segment. The format of the entry pseudo-opera- 
tion is: 



NAME FD2LD 


OPERATION 
FrELD • 


VARIABLE FD2LD 


1. A symbol, 

or 

2. Blanks 


ENTRY 


Symbol 



The name field symbol becomes the external name of 
the entry point. The variable field symbol is the in- 
ternal name of the entry point and must be an ordinary 
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is blank, the variable field symbol serves as the external 
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name. If the variable field symbol is qualified, the ( left- 
most) qualifier is used. For example, 

ALPHA ENTRY BETA 

specifies that alpha is the external name of an entry 
point into this program from another program and that 
beta is the internal name of this entry point. 

If an entry pseudo-operation refers to either an 
absolute symbol, a symbol that was defined by an 
equ or syn pseudo-operation, or a location symbol 
whose definition depends on an absolute origin within 
a relocatable assembly, it is discarded and an error 
message is issued. 



File-Description Pseudo-Operations 

Two pseudo-operations are provided by map for spec- 
ifying input/output file requirements in relocatable 
assemblies. These pseudo-operations describe files that 
are used in conjunction with Library iocs. (See the 
publication IBM 7090/7094 IBSYS Operating System: 
Input/Output Control System, Form C28-6345. ) 

ibldr generates a file control block and assigns the 
file to a buffer pool. File control blocks described in one 
program segment may be referenced in other segments. 
If the same file is described more than once, only the 
first description is effective. 

The FILE Pseudo-Operation 

The file pseudo-operation enables the programmer to 
specify input/output file requirements. The file 
pseudo-operation causes generation of a sfile card, as 
well as any setc cards needed. The format of the file 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


FILE 


External file name, options, . . . 



The symbol in the name field of the file pseudo- 
operation is the internal name of the file used by the 
programmer within his program. Whenever this name 
appears in the variable field of an instruction, the re- 
locatable reference is to the generated file control 
block for this file. 

The first subfield of the variable field is the external 
file name. The order of the subsequent subfields is 
arbitrary. 

In describing the subfields, options that may be in- 
cluded or omitted are shown in brackets. When an 
option is not specified, the standard option, which is 
shown underlined, is assumed. Braces indicate that a 
choice of the enclosed options is to be made by the 
user. Options are shown in all upper-case letters in the 
form in which they must be specified. 



External File Name is an alphameric literal of up to 
18 characters used to determine equivalence between 
files. This subfield must be specified as the first subfield 
in the variable field. It may be null ( the variable field 
may start with a comma), in which case the six- 
character name field ( left-justified with trailing blanks ) 
is inserted as the external name. 

Unit- Assignment Option 

[, primary unit] [, secondary unit] 

Two symbolic units may be specified for each file : the 
primary unit, and a secondary unit to be used as a reel- 
switching alternate. The format used for these speci- 
fications is indicated below, where the following nota- 
tion is used: 

X a real channel (specified by one of the letters A 
through H) 

P a symbolic channel (specified by one of the letters S 

through Z) 

I an intersystem channel (specified by one of the letters J 

through Q) 

k a unit number (specified by one of the numbers 

through 9) 
a access mechanism number (specified by the number 0) 

m module number (specified by one of the numbers 

through 9) 

s data channel switch or interface (specified by either of 

the numbers or 1 ) 

M model number of 729 Magnetic Tape Unit (specified by 

II, IV, V, or VI) 
D 1301 Disk Storage ( specified by the letter D ) 
N 7320 Drum Storage ( specified by the letter N ) 
H 7340 Hypertape Drive (specified by the letter H) 

The following format is used for assigning units: 



SPECIFICATION 

blank 
M 

X 

P 

X(k) 

PM 



P(k)M 



IM 

Kk) 
I(k)M 



EFFECT 

Use any available unit. 

Use any available 729 Magnetic Tape Unit 
of this model. 

Use any available unit on this channel. 

Use any available unit on this channel. 

Use kth available unit on this channel. 
Parentheses are required. 

Use any available 729 Magnetic Tape Unit 
of specified model on designated symbolic 
channel. 

Use kth available 729 Magnetic Tape Unit 
of specified model on designated symbolic 
channel. Parentheses are required. 
Use any available unit on channel I. This 
specification can be used for input and out- 
put units. 

Use any available 729 Magnetic Tape Unit 
of specified model on channel I. This speci- 
fication can be used only for output units. 
Use kth available unit on channel I. Paren- 
theses are required. This specification can 
be used for input and output units. 
Use kth available 729 Magnetic Tape Unit 
of specified model on channel I. Paren- 
theses are required. This specification can 
be used only for output units. 
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lease unit from reserve status after use. 
Parentheses are required. 

XDam/s Use 1301 Disk Storage on channel X, 

access mechanism number a (which must 
be 0), and module number m. 

XNam/s Use 7320 Drum Storage on channel X, 

access mechanism a (0), module number 
m (0, 2, 4, 6, 8) and data channel switch 
settings (0, 1). 

XHk/s Use 7340 Hypertape Drive on channel X, 

unit number k, and data channel switch s. 

IN, INI, IN2 Use the system input unit (SYSIN1) and 

the alternate system input unit (SYSIN2) 
as the primary and secondary units respec- 
tively. 

OU, OU1, OU2 Use the system output unit ( SYSOU1 ) and 

the alternate system output unit (SYSOU2) 
as the primary and secondary units respec- 
tively. 

PP, PP1, PP2 Use the system peripheral punch ( SYSPP1 ) 

and the alternate system peripheral punch 
(SYSPP2) as the primary and secondary 
units respectively. 

UTk Use system utility unit number k. 

CKk Use system checkpoint unit number k. 

RDX Use card reader on channel X. 

PRX Use printer on channel X. 

PUX Use card punch on channel X. 

INT File is internal. 

* An asterisk in the secondary unit field in- 

dicates that the secondary unit of a file is 
to be any unit on the same channel and of 
the same model as the primary unit. 

NONE No units are assigned. A file control block 

is generated but does not refer to a unit 
control block. 

File-Mounting Option 

r ( MOUNT ) "I r ( MOUNTi ) ' 

{READY } and/or <READYi 
L (DEFER )J LfDEFERi 

The file-mounting option governs the on-line message 
to the operator indicating the impending use of an 
input/output unit. The first form applies to both units; 
the second applies to the primary unit when i=l and 
to the secondary unit when i=2. Two standard options 
are indicated— one is for units assigned to system unit 

1UUCUUIJ3 ^ouu/t / aiiu U1V UU1V1 XO 1U1 

(mount). 
The effects of these operations are: 
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MOUNT 



READY 



DEFER 



Uo ; f, 



A message is printed before execution, and a 

stop occurs for the required operator action. 

MOUNT is the standard option for nonsystem 

units. 

A message is printed before execution, but no 

stop occurs. READY is the standard option for 

all input/output units assigned to system unit 

functions. 

A message and operator stop are deferred until 

the file is opened by the IOCS calling sequence. 



TSX 
PZE 



.OPEN, 4 
internal file name 



r\l +-K-IC? rkT>-f-ir*T> r\x rck-mri H * 



r\& an example oi me uie-uiQuniing option. 
MOUNTI DEFER2 
causes the mount aetion for the primary unit and the 
defer action for the secondary unit. 

Operator File-List Option 

MLIST n 

L } NOLIST J J 

LIST This file will appear in the operator's mount- 

ing instructions. 

NOLIST No message will be printed unless the 

DEFER option has been specified. 



File-Usage Option 



[ 



/INPUT 

j OUTPUT 

) INOUT 

(CHECKPOINT (or CKPT) 







INPUT 

OUTPUT 

INOUT 



CHECKPOINT 

(or CKPT) 



This is an input file. 

This is an output file. 

This file may be either an input or an 

output file. The object program sets 

the appropriate bits in the file block. 

The file is initially set at input. 

This is a checkpoint file. 



Block-Size Option 

[, BLOCK =xxxx (or, BLK=xxxx)] 
xxxx is an integer (0-9999) that specifies block size for 
this file. If the block-sequence and/or check-sum op- 
tions ( see below ) are specified, a word must be added 
in determining block size. If the block option is 
omitted, the assembly program assumes a block size 
of 14 for bcd or mxbcd files and 256 for bin and mxbin 
files. 

Activity Option 
[, ACT=xx] 
xx is an integer (0-99) that specifies activity of this 
file in relation to other files. If the activity subfield is 
omitted, activity is assumed to be I. The activity 
value is used in determining the number of input/ 
output buffers assigned to each buffer pool in the object 



Reel-Handling Option 



JONEREEL /' 

MULTIREEL > 

((or REELS) )_ 

ONEREEL 
MULTIREEL 
(or REELS) 

nNOSEARCH I "I 
SEARCH ( J 
NOSEARCH 



for unlabeled files only 



SEARCH 



general option specified. 



No reel switching should occur. 
Reel switching will occur. Every out- 
put file will switch reels if an end-of- 
tape condition occurs. 

for labeled files only 

If an incorrect label is detected when 
opening an input file, IOCS causes a 
stop for operator action. 
If an incorrect label is detected, IOCS 
enters a multireel search for the file 
with the desired label. 
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File-Density Option 

[high\ 
\low/ 

(200 ) 
556 \ 
800 1 

HIGH Tape-density switch is assumed to be set so that 
execution of an SDH will result in using correct 
density. 

LOW Tape-density switch is assumed to be set so that 

execution of an SDL will result in using correct 
density. 

200 Tape density switch is assumed to be set so that 

execution of an SDL will result in a file-record- 
ing density of 200 cpi. 

556 Tape density switch is assumed to be set so that 

execution of an SDL will result in a file-record- 
ing density of 556 cpi. 

800 Tape density switch is assumed to be set so that 

execution of an SDH will result in a file-record- 
ing density of 800 cpi. 

If a system unit is assigned to this file, system set den- 
sity supersedes the density specified by these options. 
Mode Option 

ns? n 

lMXBCDf 

LImxbin ; J 

BCD File is in BCD mode. 

BIN File is in binary mode. 

MXBCD File is in mixed mode, and first record is 

BCD. 
MXBIN File is in mixed mode, and first record is 

binary. 

Label-Density Option 
|-(SLABEL \~l 

Jhilabel f 

)LOLABELf 
LlFLABEL )J 
SLABEL All header label operations performed at 

installation standard density, which is 

currently high density. 
HILABEL All header label operations performed at 

high density. 
LOLABEL All header label operations performed at 

low density. 
FLABEL All header label operations performed at 

same density as file. 

Regardless of these options, the label pseudo-opera- 
tion must be used to specify a labeled file. If label 
density is not specified, all label options are performed 
at the density that is high density at the particular 
installation. 

Block-Sequence Option 

(NOSEQ )~| 
"(SEQUENCE}' 



[ 



/(orSEQ) ) 



NOSEQ 



SEQUENCE 
(orSEQ) 



Block-sequence word neither checked if 
reading, nor formed and written if 
writing. 

Block-sequence word checked if read- 
ing, or formed and written if writing. 
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NOCKSUM Check sum neither checked if reading, 

nor formed and written if writing. 

CKSUM Check sum checked if reading, or 

formed and written if writing. 

Check-sum options may not be specified unless a 

block-sequence option has been specified. 

Checkpoint Option 

HNOCKPTSn 
LjCKPTS }J 

NOCKPTS No checkpoints initiated by this file. 

CKPTS Checkpoints initiated by this file. 

Checkpoint-Location Option 

[, AFTER LABEL] 
Checkpoints are written following the label on this file 
when reel switching occurs. If ckpts is specified and 
this field is omitted, checkpoints are written on the 
checkpoint file when reel switching occurs. 

File-Close Option 

• /SCRATCH} -l 
j PRINT f 
) PUNCH ( 

. (hold ; J 

SCRATCH File is rewound at end of application; 

PRINT File is to be printed and is rewound and 

unloaded at end of application. PRINT 
will appear in on-line removal message 
at end of execution. 

PUNCH File is to be punched and is rewound 

and unloaded at end of application. 
PUNCH will appear in on-line removal 
instructions. 

HOLD File is to be saved and is rewound and 

unloaded at end of application. HOLD 
will appear in on-line removal instruc- 
tions. 

If the unit assigned is system input unit 1, system out- 
put unit 1, or system peripheral punch unit 1, the unit 
will not be rewound and the removal message will not 
be printed. 

Starting Cylinder-Number Option 
[, CYLINDER = xxx ( or, CYL = xxx ) ] 
xxx is the number (000-249 for disk, 000-009 for drum) 
of the starting cylinder for this file. The equals sign is 
required. When disk or drum storage is specified for 
a file, the starting cylinder number must be specified 
by the user. 

Cylinder-Count Option 

[, CYLCOUNT=xx (or, CYLCT=xxx)] 
xxx is the number (000-250 for disk, 000-010 for drum) 
of consecutive cylinders to be used by this file. The 
equals sign is required. When disk or drum storage is 
specified for a file, cylinder count must be specified 
by the user. 

Disk W rite-Checking Option 
[, WRITECK] 
Write-checking is performed after each disk-write or 
drum-write sequence .for this file. 

Hypertape Reel-Switching Options 



Check-Sum Option 

n NOCKSUM I "I 
CKSUM \ J 



[ 



Yhrfp }-i 
Jhrnfp f 

JHNRFP ( 
IHNRNFP; J 
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These options may be used in conjunction with the 
Hypertape option, hyper, where reel switching is likely 
to occur. If any of these options are used but hyper 
is not specified, a warning message is issued. 
The effects of these options are: 

HRFP Hypertape, rewind, file protect. 

TTTiXTtm TT t • 1 CI i_ _». 

xunmrr nypenape, rewiiiu, iiu me piuieci. 

HNRFP Hypertape, no rewind, file protect, 

HNRNFP Hypertape, no rewind, no file protect. 

Five subfields provide information for cross-check- 
ing by ibldr. These subfields, the conversion, block- 
size check, nonstandard label routine, Hypertape, and 
pool-attachment options, are not placed on the $file 
card. 

Conversion Option 

{""(nOHCVN) 

UREQHCV > 
OPTHCV ) 

NOHCVN Alphameric-to-BCD conversion routine not 

necessary. File may not be assigned to 
card equipment. 

REQHCV Alphameric-to-BCD conversion routine re- 

quired. File must be assigned to card 
equipment. 

OPTHCV Alphameric-to-BCD conversion optional. 

Regardless of the conversion options specified, it is the 
responsibility of the programmer to provide the re- 
quired conversion routines. File may be assigned to 
any input/output device. 
Block-Size Check Option 



nMULTI=xxxx 
MIN=xxxx 
MULTI=xxxx 
MIN=xxxx 



|] 



Block size is a multiple of xxxx. 
Minimum block size is xxxx. 



Only one of the block-size check options may appear. 
The quantity specified is used by ibldr to check the 
block size indicated by the block option. If neither 
option appears, block size is assumed to be exactly 
that specified by the block option. 
Nonstandard-Label-Routine Option 

[ , NSLBL = symbol] 
The symbol is the name of a nonstandard-iabel routine. 
If the label routine is part of the program segment 
being assembled, the label routine must be made a 
control section with the symbol used as its external 
name. If the label routine is not part of this program 
segment, the symbol must be a virtual symbol. 
Hypertape Option 

[ ,HYPER ] 
hyper must be specified if a program requires Hyper- 
tape for a particular file. If reel switching may occur, 
the Hypertape reel-switching options may be used in 
conjunction with hyper. However, use of Hypertape 
reel-switching options without specifying hyper re- 
sults in a warning message. 



If a file may be attached to a Hypertape or a 729 
Magnetic Tape Unit, the hyper specification is not 
necessary. 

Pool-Attachment Option 



MPOOL M 
L I NOPOOL \ I 



NOPOOL A file control block is to be generated, but 

this file is not to be attached to a pool. 

If a checkpoint (or ckpt) is specified for the file- 
usage option, nopool is automatically assumed. 

If the nopool option is specified, it is assumed that 
the iocs initialization sequences of .defin and .attac 
for this file will be executed by the object program 
prior to opening the file. (See the publication IBM 
7090/7094 IBSYS Operating System: Input/Output 
Control System, Form C28-6345. ) 

Example of FILE pseudo-operation 
For example, the options for an input file might be 
specified in the instruction 

INPUT FILE , A ( 1 ) ,RE ADY,BLK = 20, 

556,HOLD 

Since the first subfield is null, the symbol input in the 
name field is regarded as the external name. The re- 
maining subfields specify the first available unit on 
channel 1, the file-mounting option, a block size of 20 
words, a file density of 556 characters per inch, and the 
file is to be saved and must be rewound and unloaded 
at the end of the application. 

The LABEL Pseudo-Operation 

The label pseudo-operation enables the programmer 
to label a file and causes generation of the slabel con- 
trol card. Whereas the file pseudo-operation describes 
the file characteristics, label simply labels the file. The 
lOrrnat or tue label pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, 

or 

2. Blanks 


LABEL 


Five subfields: 

1. File name, 

2. File serial number or disk 
or drum Home Aduress-2, 

3. Reel sequence number, 

4. Retention period (in days) 
or date, 

5. File identification name 



The file name is an alphameric name of eighteen or 
fewer bcd characters. If this subfield is null (the vari- 
able field begins with a comma), the symbol in the 
name field is inserted as the file name. If the name field 
is also blank, 000000 is inserted as the file name. 

The file serial number is an alphameric subfield of 
five or fewer characters, and it may be null. If the label 
is for a file on disk or drum, this subfield must contain 
two bcd characters to specify the Home Address-2. 
(For further information, see the publication General 
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Information Manual, IBM 1301 Disk Storage with IBM 
7000 Series Data Processing Systems, Form D22-6576. ) 
The reel-sequence number is a numeric subfield of 
four or fewer digits, and it may be null. 

For retention period in days, four or fewer numeric 
characters are used. For date, two or fewer numeric 
characters represent the year, and three or fewer 
numeric characters represent the day of the year. The 
year and the day of the year are separated by the 
character / ( slash ) . 

The file identification name is an alphameric subfield 
of eighteen or fewer bod characters. This subfield may 
contain blanks but not commas. A comma will termi- 
nate this subfield, and excessive subfields will be 
flagged as errors. This subfield may also be null. 

For example, 

LABEL INVOICE„241,63/248,PRIMARY FILE 

specifies that the invoice file be labeled, provides its 
reel-sequence number of 241, dates it as the 248th day 
of 1963, and specifies primary file as the file identifica- 
tion name. 

The variable field of the label pseudo-operation 
must be contained on one card. No etc cards may be 
used following label. 

The variable field is checked for errors. If there are 
more than five subfields, the variable field is truncated, 
only the first five subfields are used, and a warning 
message is printed. If there are fewer than five sub- 
fields, an appropriate number of commas is supplied 
so that the slabel card always has the required sub- 
fields and a warning message is printed. 

Each subfield is then checked for length except for 
the last one. Subfields that are longer than the specified 
maximums are truncated to the maximum number of 
characters allowed for each, and a format error 
message is printed. Numeric subfields are also checked 
for validity, and the presence of any nonnumeric char- 
acters causes a format error message to be printed. 



Operation-Defining Pseudo-Operations 

Three pseudo-operations that define symbols as opera- 
tion codes are provided by map. 

The OPD Pseudo-Operation 

The opd (Operation Definition) pseudo-operation de- 
fines the symbol appearing in the name field as an 
operation code. The format of the opd pseudo-opera- 
tion is: 



The 12-digit machine operation code definition in the 
variable field must be specified according to the gen- 
eral format given in Appendix C. 

The opd pseudo-operation defines the symbol in the 
name field as an operation code. The symbol must be 
defined by the opd pseudo-operation before its use in 
an operation field. 

For example, 

ALPHA OPD 430106004500 

defines alpha as an operation code having the same 
effect as the machine instruction cla. 

The OPVFD Pseudo-Operation 

The opvfd (Operation Variable Field Definition) 
pseudo-operation defines the symbol in the name field 
as the operation code represented by the expression 
in the variable field. The format of the opvfd pseudo- 
operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


OPVFD 


From 1 to 36 subfields, sep- 
arated by commas 



The format of the variable field is the same as that 
given for the vfd pseudo-operation. The variable field 
expression must result in a 36-bit word having the 
format given in Appendix C. 

The symbol in the name field becomes the mnemonic 
operation code of the instruction. The symbol must be 
defined by opvfd before being used in an operation 
field. 

For example, 

ALPHA OPVFD 06/43,012/0600,018/4500 

defines alpha as an operation code having the same 
effect as the machine instruction cla. 

The OPSYN Pseudo-Operations 

The opsyn ( Operation Synonym ) pseudo-operation 
equates the symbol in the name field to the mnemonic 
operation code in the variable field. The format of the 
opsyn pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


OPSYN 


Mnemonic operation code 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


OPD 


12-digit octal machine opera- 
tion code definition 



The mnemonic operation code in the variable field 
must be a valid operation code (i.e., a machine opera- 
tion code, a pseudo-operation code, a macro-operation 
code, or a code that has been defined previously by 
opd, opvfd, or another opsyn ) . 

If a previously defined operation code is redefined 
with opd, opvfd, or opsyn, a warning message is issued. 
For example, 

CLA OPSYN CAL 
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redefines cla as cal, i ne message warns tne program- 
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operation code. 



miSC&ii&fi&OUS Ps6u€l0-Oo6f€if iOftS 

The END Pseudo-Operation 

The end pseudo-operation signals the end of the sym- 
bolic deck and terminates assembly. The end operation 
must be present and must be the last card in the sym- 
bolic deck. The format of the end pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


END 


1. An element, or 

2. Blanks 



In a relocatable assembly, the value of the element 
in the variable field is the nominal starting point of the 
program segment. 

The end pseudo-operation performs the following 
functions in an absolute assembly: 

1. Any binary output waiting in the punch buffer is 
written out. 

2. A binary transfer card to which control is trans- 
ferred is produced. It has a transfer address that is the 
value of the expression in the variable field. 

If unpnch is in effect, no cards are punched. 

The ETC Pseudo-Operation 

The variable field of most instructions may be ex- 
tended over additional cards by using the etc pseudo- 
operation. The format of the etc pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Ignored 


ETC 


Subfields, separated by com- 
mas, or partial subfields 



The etc pseudo-operation appends its variable field 
as a continuation of the variable field of the previous 
instruction. The blank that separates the variable field 
from the comments field of a card is an end-of-card 
indicator and not an end-of-variable-field indicator. 
The number of etc cards in one group is generally lim- 
ited by the size of the resultant expression and/or the 
number of subfields. A variable-field expression is lim- 
ited to about 100 elements, operators, and/or subfields. 
No element of an expression may be split between 
two cards. For example, the instruction 



TIX 



could be written 



TIX 



NAME + 1,4,1 



NAME+1 



or 



TIX 
ETC 
ETC 
ETC 



TIX 
ETC 



but could not be written 

TIX 
ETC 



NAME 

+ 1,4 
,1 



NAME + 1,4, 
1 



NA 

ME + 1,4,1 



The following operations may not be followed by an 
etc card: 



ABS 

BCI 

DEC 

DETAIL 

EJECT 

END 

ENDM 

ENDQ 

EVEN 

FUL 

IFF 

IFT 



INDEX 

LABEL 

LBL 

LDIR 

LIST 

LORG 

NOCRS 

NULL 

OCT 

OPD 

OPSYN 

ORGCRS 



PCC 

PCG 

PMC 

PUNCH 

QUAL 

REM 

TITLE 

TTL 

UNLIST 

UNPNCH 

USE 



If an etc follows any of these operations except end, 
the etc will be ignored and a low-severity warning 
message issued. 

The REM Pseudo-Operation 

The rem ( Remarks ) pseudo-operation permits remarks 
to be entered into the assembly listing. The format of 
the rem pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FDELD 


Any informa- 
tion 


REM 


Any information 



The contents of columns 8-10 (the operation field) 
are replaced by blanks, and the remaining contents of 
the card are copied onto the assembly listing. The rem 
pseudo-operation supplements the remarks card that 
has * in column 1. In a macro-definition, the variable 
••cm vAi. me ncivjL caiu ia o^cxiinoa iui suuauiuiauic pa- 
rameters, whereas the * card causes an error message 
but is otherwise completely ignored. 

The KEEP Pseudo-Operation 

The keep pseudo-operation permits the programmer 
to specify a debugging dictionary that contains only 
those symbols he wishes to use in debug requests. The 
format of the keep pseudo-operation is: 



or 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


KEEP 


One or more symbols ( which 
may not be qualified), 
separated by commas 
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The symbols in the variable field are entered into 
the debugging dictionary along with any modal and 
dimensional information that was supplied in bss, bes, 
equ, and syn pseudo-operations. Any number of keep 
pseudo-operations may appear in a program. If the 
nodd option was specified on the sibmap card, the keep 
pseudo-operation is ignored. ( For further information 
concerning debugging and the debugging dictionary, 
see the publications IBM 7090/7094 IBSYS Operating 
System: IBJOB Processor, Form C28-6275, and IBM 
7090/7094 IBSYS Operating System: IBJOB Processor 
Debugging Package, Form C28-6362. ) 



Absolute-Assembly Pseudo-Operations 

The pseudo-operations abs, ful, punch, unpnch, and 
tcd are effective in absolute assemblies only. They are 
ignored in a relocatable assembly. 



The ABS Pseudo-Operation 

The abs (Absolute) pseudo-operation specifies card 
output in the standard 22-word-per-card column-binary 
card format. The format of the abs pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ABS 


Ignored 



Binary cards are normally punched in the abs mode 
unless otherwise specified. The abs pseudo-operation 
always causes the next output word to start a new card. 
Any words remaining in the punch buffer are written 
out in the previously specified format. 

Column-binary card format is described in the pub- 
lication IBM 7090/7094 IBSYS Operating System: 
IBJOB Processor, Form C28-6275. 

The FUL Pseudo-Operation 

The ful pseudo-operation specifies card output in the 
24-word-per-card "full" mode. The format of the ful 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


FUL 


Ignored 



The ful pseudo-operation always causes the next 
output word to start a new card. Any words remaining 
in the punch buffer are written out in the previously 
specified format. 

The full mode card format is described in the publi- 
cation IBM 7090/7094 IBSYS Operating System: IBJOB 
Processor, Form C28-6275. 



The PUNCH and UNPNCH Pseudo-Operations 

The punch and unpnch pseudo-operations cause re- 
sumption and suspension, respectively, of binary card 
punching. The format of the punch and unpnch 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PUNCH or 
UNPNCH 


Ignored 



The TCD Pseudo-Operation 

A binary transfer card directs an absolute loader pro- 
gram to stop loading cards and to transfer control to a 
designated location. In most cases, a transfer card is 
required at the end of the binary deck. In absolute 
assemblies, the end pseudo-operation causes a binary 
transfer card to be punched. However, the tcd pseudo- 
operation can cause a transfer card to be produced 
before the end of the binary deck. 

The format of the tcd pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


TCD 


A symbolic expression 



The tcd pseudo-operation performs the following 
two functions : 

1. Any binary output waiting in the punch buffer is 
written out. 

2. A binary transfer card is produced having a trans- 
fer address that is the value of the expression in the 
variable field. See the publication IBM 7090/7094 
IBSYS Operating System: IBJOB Processor, Form C28- 
6275, for a description of the format of a transfer card. 

If unpnch is in effect, no cards are punched. 



List-Control Pseudo-Operations 

The PCC Pseudo-Operation 

The pcc (Print Control Cards) pseudo-operation has 
the following format: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PCC 


Either: 

1. ON 

2. OFF 

3. Blanks 

4. Any information 



Unless the unlist pseudo-operation is in effect, pcc 
on causes the listing of the following cards : ttl, title, 

LBL, LIST, INDEX, SPACE, EJECT, DETAIL, PCG, PMC, IFT, 

iff, and goto, and any cards under the scope of the ift, 
iff, and goto pseudo-operations that are not assem- 
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bled, pcc off suppresses listing of tnese cards and is tne semoiy program encounters a detail operation, title 



Ulllldl 111V/V4\^. 



T^ho Ti/~v~< r\nfr\ 



X\J UJ. TV «-*. f l3 XiiJI.V'VA \*>» r»vuu 

UNLIST is in effect, If the variable field is blank or 
contains anything other than on or off, the current 
setting of the pcc switch is inverted. 



The UNLIST Pseudo-Operation 

The unlist pseudo-operation causes all listing to be 
suspended. The format of the unlist pseudo-operation 
is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FDSLD 


Blanks 


UNLIST 


Ignored 



The unlist pseudo-operation is itself listed unless 
a previous unlist is still in effect. After an unlist, no 
lines are listed by the assembly program until a list 
or end pseudo-operation is encountered. 

The LIST Pseudo-Operation 

The list pseudo-operation causes listing to be re- 
sumed following an unlist. The format of the list 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FEELD 


VARIABLE FDSLD 


Blanks 


LIST 


Ignored 



The list pseudo-operation does not appear in the 
assembly listing unless the mode of pcc is on. 

The TITLE Pseudo-Operation 

The title pseudo-operation abbreviates the assembly 
listing by eliminating certain kinds of information. The 
format of the title pseudo-operation is : 



NAME FDELD 


OPERATION 
FDELD 


VARIABLE FIELD 


Blanks 


TITLE 


Ignored 



title causes the assembly program to exclude the 
following information from the listing: 

1. Any line that contains octal information except 
the instruction that causes it, i.e., all but the first word 
generated by oct, dec, bci, and vfd 

2. All but the entire first iteration of each instruc- 
tion in the range of a dup 

3. All complex fields in a relocatable assembly 

4. The expansion of save and all but the first three 
instructions in the expansion of call 

5 All litfrnlc in fli*> T.it*»ml Pr»r»l pvopnf fko fire* 

■ • -- ....__. — ~_j_.-. v — ^. "u. 

A title pseudo-operation is effective until the as- 



is no* - li c t°d ex^e 1 " 4 * when *he mode of pcc is on. 



The DETAIL Pseudo-Operation 

The detail pseudo-operation causes the listing of 
Generated at° *o ' n£t res ii med after it has be°n sus- 
pended by a title pseudo-operation. The format of 
the detail pseudo-operation is: 



NAME FDSLD 


OPERATION 
FDSLD 


VARIABLE FIELD 


Blanks 


DETAIL 


Ignored 



The sole effect of the detail operation is to cancel 
the effect of a previous title pseudo-operation. If 
title is not in effect, the detail operation is ignored 
by the assembly program. The detail operation does 
not appear in the assembly listing unless the mode of 
pcc is ON. 

The EJECT Pseudo-Operation 

The eject pseudo-operation causes the next line of the 
listing to appear at the top of a new page. The format 
of the eject pseudo-operation is: 



NAME FDSLD 


OPERATION 
FDSLD 


VARIABLE FDSLD 


Blanks 


EJECT 


Ignored 



The eject pseudo-operation appears in the assembly 
listing only if the mode of pcc is on. 

The SPACE Pseudo-Operation 

The space pseudo-operation permits one or more 
blank lines to be inserted in the assembly listing. The 
format of the space pseudo-operation is: 



NAME FDSLD 


OPERATION 
FEELD 


VARIABLE FDSLD 


Blanks 


SPACE 


1. A symbolic expression, or 

2. Blanks 



The definition of the expression in the variable field 
determines the number of blank lines in the assembly 
listing. If the value of the expression is zero or the 
variable field is blank, one blank line appears, space 
itself is listed only if the mode of pcc is on. 

The LBL Pseudo-Operation 

Serialization of a deck normally begins with the first 
four characters of the deck name, which are left- 
justified and filled with trailing zeros. However, 
serialization can be altered by using the lbl pseudo- 

operation is: 



/T nholl nron/ift. 
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NAME FIELD 



Blanks 



OPERATION 
FIELD 



LBL 



VARIABLE FIELD 



One or two subfields, separated 
by a comma: 

1. Up to 8 BCD characters, 
which may or may not be 
followed by a comma if the 
second subfield is not present 

2. The word BEGIN followed 
by a blank or a comma 



lbl causes binary cards to be identified and serialized 
in columns 73-80, as follows: 

1. Serialization begins with the characters appear- 
ing in the variable field, which is left-justified and 
filled with terminating zeros. 

2. Serialization is incremented by one for each 
card until the rightmost nonnumeric character or the 
seventh character is reached, after which the numeric 
portion recycles to zero. The two leftmost characters 
are regarded as fixed, even though they may be 
numeric. 

For example, if the variable field is coded as id, the 
first card is identified and serialized as idoooooo. 

If the variable field is coded as instro3, serialization 

is as follows: 

INSTR030 
INSTR031 



INSTR999 
INSTR000 



If the begin option is not included, reserialization 



begins 



the binary card following the one that is 



currently being punched. Serialization can be altered 
at any point in the program by using additional lbl 
pseudo-operations. 

If the begin option is included, the lbl will be effec- 
tive from the beginning of the program, serializing all 
binary cards, including the $file and slabel cards 
created by ibmap as a result of the corresponding 
pseudo-operations, no matter where the lbl appears 
in the program. If more than one lbl pseudo-operation 
with the begin option is used, only the last one will be 
effective. Any lbl pseudo-operations that do not con- 
tain the begin option are processed normally. 

If the variable field of the lbl currently in effect 
does not end with a comma, the assembly program 
prints the phrase 

BINARY CARD ID.Number 

at the beginning of each card. If a comma is used to 
terminate the variable field, printing of this phrase is 
suppressed. Printing of this phrase can be reinitiated 
by using an lbl pseudo-operation ending in a blank. 

lbl is listed only if the mode of pcc is on. 



The INDEX Pseudo-Operation 

The index pseudo-operation provides a table of con- 
tents of important locations within an assembly. The 
format of the index pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


INDEX 


Symbols, separated by commas 



The first appearance of an index card causes the 
message 

TABLE OF CONTENTS 
to be listed. Each subfield of an index pseudo-opera- 
tion causes the symbol and its definition to be listed. 
If a virtual symbol is used, its definition will be the 
control section number assigned to the symbol. 

index pseudo-operations may appear anywhere in 
the source program and need not be grouped. The 
listing generated by index pseudo-operations is in- 
serted where the pseudo-operations appear. 

For meaningful commentary, index pseudo-oper- 
ations can be grouped and interspersed with ex- 
planatory remarks cards. 

An index pseudo-operation is not processed if any 
of the following three conditions exist: 

1. It is in a macro-expansion and pmc is off. 

2. It is in the range of a dup pseudo-operation and a 
title pseudo-operation is in effect. 

3. An unlist pseudo-operation is in effect. 
Listing of the index card itself is governed by the 

mode of the pcc switch. 

The variable field of an index pseudo-operation 
cannot be extended by use of the etc pseudo-operation. 

The PMC Pseudo-Operation 

The pmc pseudo-operation causes (or suppresses) list- 
ing of the card images generated by macro-instructions 
and by the return pseudo-operation. The format of 
the pmc (Print Macro Cards) pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


PMC 


Any one of: 

1. ON 

2. OFF 

3. Blanks 

4. Any information 



on in the variable field causes listing of the card 
images generated by macro-instructions; off, which is 
the normal mode, suppresses such listing. A blank 
variable field or one containing any information other 
than on or off inverts the current setting of the pmc 
switch. 

etc cards extending the variable field of a macro- 
instruction are listed even if the mode of pmc is off. 

Listing of the pmc card is controlled by the pcc 
pseudo-operation . 
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The ttl (Subtitle) pseudo-operation generates a sub- 
heading in the listing. The format of the ttl pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


TTL 


A string of BCD characters 
starting in card column 12 



Card columns 13-72 are used in words 4-13 of a 
generated subheading, which will appear on each 
page, ttl also forces a page ejection. 

A subheading may be replaced by the variable field 
of another ttl and may be deleted by a ttl with a 
blank variable field. 

Listing of the ttl card is controlled by the pcc 
pseudo-operation. 

The PCG Pseudo-Operation 

The pcg (Print Control Group) pseudo-operation 
causes listing of the relocatable control bits of each 
assembled word. The format of the pcg pseudo- 
operation is: 





OPERATION 




NAMEFTELD 


FIELD 


VARIABLE FIELD 


Blanks 


PCG 


Any one of: 

1. ON 

2. OFF 

3. Blanks 

4. Any information 



on in the variable field causes listing and off sup- 
presses listing of the relocatable control bits for each 
assembled word, on is the normal mode. A blank 
variable field or one containing any information other 
than on or off inverts the current setting of the pcg 
switch, pcg is ignored in an absolute assembly. 

pcg is listed if the mode of pcc is on. 



Special Systems Pseudo-Operations 

Users of the map language are provided with a wide 
range of subroutines which are included in the sys- 
tems library. A group of system pseudo-operations 
permits the transfer of control and data between the 
main program and the subroutine. Details about 
specific calling sequences are provided in the publica- 
tions IBM 7090/7094 IBSYS Operating System: IBJOB 
Processor, Form C28-6275 and IBM 7090/7094 IBSYS 
Operating System: Input/Output Control System, 
Form C28-6345. 

The CALL Pseudo-Operation 

The call pseudo-operation produces the standard 
ibjob subroutine calling sequence. The format of the 
call pseudo-operation is: 



NAME FD2LD 


OPERATION 
FD2LD 


VARIABLE FD2LD 


Symbol 


CALL 


One or more subfields: 

1. Symbol or ** 

2. Calling sequence param- 
eters 

o. mLttgt returns 

4. Identification number 



The first subfield in the variable field must contain 
an unqualified symbol (the name of a subroutine) or 
**. The next subfield contains the parameters of the 
calling sequence (if any), enclosed in parentheses and 
separated by commas. These may be any symbolic ex- 
pression. 

Error returns (if any), separated by commas, occupy 
the next subfield. The last subfield is an identification 
number (if desired), less than 32,768 and delimited by 
apostrophes. If specified, this number appears in the 
calling sequence in place of the assembly line number. 
When an identification number is not specified, the 
assembly line number appears. 

For example, a typical call operation might be 
coded 



LCS 



CALL name( argl,arg2, . . . ,argn) 

ETC retl,ret2, . . . .retn'id' 



where name is the name of a subroutine; argl, arg2, 
. . . , argn are the parameters of the calling sequence; 
retl, ret2, . . . , retn are the error returns; and 'id' is the 
identification number. 

A comma should not precede the left parenthesis, 
follow the right parenthesis, nor precede the 'id'. 

If the subroutine is part of the program being assem- 
bled, the reference is to the routine in the program. 
However, if the subroutine is not part of the program 
being assembled, the symbol in the first subfield of the 
variable field becomes the external name of the sub- 
routine called. If ** is used, a constant zero becomes 
the called address. 

The remaining subfields generate the calling se- 
quence. 

Eviw;nt|mc m£ fj*"* ^ALL Pssudo-^'^erGiion 
The linkage produced by 



LCS 



is 



LCS 



CALL 
ETC 

TSX 
TXI 
PZE 
PZE 



PZE 
TRA 



TRA 



NAME(Pl,...,Pn)Rl, 
. . . ,Rm'ID' 

NAME,4 
*+2+n+m„n 
ID„Linkage Director 
PI 



Pn 
Rm 



Rl 
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where P is a subroutine parameter, R is an error 
return, n is the number of parameters and m is the 
number of error returns. The Linkage Director is a 
location unique for each assembly, and has no associ- 
ated symbol. It may be given a symbolic designation 
using the ldir pseudo-operation. 

The operation 

LCS CALL NAME(P1,P2) 



produces 






LCS 


TSX 
TXI 
PZE 

PZE 
PZE 


NAME,4 

* + 2+2 + 0„2 

Line number,, Linkage Director 

PI 

P2 


The statement 




LCS 


CALL 


NAME,R1 


produces 






LCS 


TSX 
TXI 
PZE 
TRA 


NAME,4 

* + 2 + + l„0 

Line number„Linkage Director 

Rl 


The statement 




LCS 


CALL 


NAME 


generates 






LCS 


TSX 
TXI 
PZE 


NAME,4 

*+2+0 + 0„0 

Line number„Linkage Director 



The SAVE Pseudo-Operation 

The save pseudo-operation produces the instructions 
necessary to save and restore the index registers and 
indicators, to disable and restore all operative traps, 
to provide error returns used by a subprogram, and 
to store the contents of index register 4 in sysloc and 
in the Linkage Director. The format of the save 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FBELD 


Symbol 


SAVE 


Up to 7 subfields containing 
integers or immediate sym- 
bols and any or all of the 
letters I, D, E 



The order in which the subfields in the variable field 
of the save pseudo-operation are used is not important. 
All subfields are optional. 

As many as 7 numeric subfields may be used to 
specify the index registers that are to be saved and 
restored. Immediate symbols may also be used to 
specify index registers. Any or all index registers may 
be specified in any order. 

Index registers are saved in the order 4, 1, 2, 3, 5, 
6, 7 and are restored in the opposite order. Index reg- 



ister 4 is automatically saved and restored, although 
it may still be specified. 

One of the three remaining subfields is literally the 
character I; another is literally the character D; and 
the last is literally the character E. 

The presence of I signifies that the sense indicators 
are to be saved and restored. 

The presence of D causes all operative traps to be 
disabled and restored. 

The presence of E generates the instructions neces- 
sary to facilitate use of error returns in the call 
pseudo-operation. 

The contents of index register 4 are stored in the 
Linkage Director each time the save pseudo-operation 
is executed, sysloc is a standard communication loca- 
tion used by all programs loaded under ibldr. If the 
assembly is absolute ( the absmod option is specified ) , 
the symbol sysloc must be defined by the programmer. 

The general form of the save pseudo-operation is: 

locsym SAVE ( Xi, . . . ,X k )I,D,E 



or 



locsym 



SAVE 



Xi, . . . ,X k ,LD,E 



Expansions of the SAVE Pseudo-Operation 

The instruction 

LCS SAVE 2,1,1 

or its equivalent 

LCS SAVE (2,1)1 

specifies that index registers 2 and 1 and the sense 
indicators are to be saved. 



The expansion is: 

ENTRY 

LCS TXI 

AXT 

AXT 

. .0001 AXT 

LDI 

. .0002 TRA 

PZE 

. .0003 STI 

SXA 

SXA 

SXA 

SXA 

SXA 

The instruction 

LCS SAVE 

generates 

ENTRY 

LCS TXI 

AXT 

. .0001 AXT 

. .0002 TRA 



LCS 

. .0003„0 
** o 
** i 

** 4 

..00102 + 1 
1,4 

..00102 + 1 
SYSLOC,4 
Linkage Director,4 
. .0001,4 
..0001-1,1 
..0001-2,2 



LCS 

. .0003„0 
**,2 

1,4 
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. .0003 SXA SYSLOC.4 

CIS 4 T ■ 1____. T-V.'__,.l.„_ A 

oyvrv LjIHKage jL-/iieuiOi,*± 

SXA . .0001,4 

SXA ..0001-1,2 

In the next two examples, the instructions generated 
because of usin^ the letters I, D ; or E in the subfield 
of a save pseudo-operation are identified by the ap- 
pearance of the particular letter in the comments field 
of the generated instruction. 

The instruction 

LCS SAVE 2,I,D 

generates 



ENTRY 



LCS 



LCS 



.0001 



.0002 



. .0003 



TXI 


. .0003„0 




AXT 


** 9 




AXT 


** A 




LDI 


. .0002 + 1 


I 


NZT 


.TRPSW 


D 


ENB* 


.TRAPX 


D 


TRA 


1,4 




PZE 




I 


XEC 


SYSDSB 


D 


STI 


..0002+1 


I 


SXA 


SYSLOC,4 




SXA 


Linkage Director,4 


SXA 


. .0001,4 




SXA 


..0001-1,2 





Locations sysdbs, .trpsw, and .trapx are in the Sys- 
tem Monitor (see the publication IBSYS Operating 
System: System Monitor (IBSYS), Form C28-6248). 
A switch at .trpsw indicates whether enabling is per- 
missible at this time; .trapx gives the address of the 
location that contains the bits for proper enabling. 
(Note that the enabling instruction below refers to 
.trapx indirectly. ) 

The following sequence illustrates the expansion 
that is generated when the E option is specified: 

LCS SAVE (2)I,D,E 



generates 










ENTRY 


LCS 




LCS 


TXI 


. .0003,,** 






LDC 


LCS,4 


E 




SXD 


*+5,4 


E 




LAC 


. .0001.4 


E 




TXI 


* + 1,4,1 


E 




SXA 


* + l,4 


E 




LXA 


** A 


E 




TXI 


* + l 4 ** 


E 




SXA 


. .0002,4 


E 




AXT 


** o 




. .0001 


AXT 


** 4 






LDI 


..0002 + 1 


I 




NZT 


.TRPSW 


D 




ENB* 


.TRAPX 


D 


. .0002 


TRA 


** 


E 




PZE 




I 


. .0003 


XEC 


SYSDSB 


D 




STI 


..0002 + 1 


I 




SXD 


LCS,0 


E 




SXA 


SYSLOC,4 






SXA 


T ;«T^rr^ T» 


"ofT!' 




SXA 


. .0001,4 






SXA 


. .0001,1,2 





If the save pseudo-operation has no symbol in the 
name field, a symbol will be generated and an error 
message will be printed. 

The SAVEN Pseudo-Operation 

The saven pseudo-operation produces the instructions 
necessary to save and restore the index registers used 
by a subprogram. The format of the saven pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Symbol 


SAVEN 


Up to 10 subfields 



The saven pseudo-operation is similar to save except 
that the instructions 

ENTRY LCS 

SXA Linkage Director,4 

are not generated, saven is generally used when en- 
tering a subroutine from another subroutine without 
destroying the linkage information. If the saven 
pseudo-operation has no symbol in the name field, a 
symbol will be generated and an error message will 
be printed. If the variable field is blank, index register 
4 is saved and restored. 

The RETURN Pseudo-Operation 

The return pseudo-operation is designed for use with 
call and save, making use of the error ( or alternate ) 
returns used in these operations. 

The format of the return pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


RETURN 


1 or 2 subfields separated by 
a comma: 

1. A symbol, 

2. An integer, a symbol, or 
an immediate symbol 



The first subfield in the variable field of the return 
pseudo-operation is required. It contains the name 
of the associated save pseudo-operation. If the second 
subfield is present, it specifies the particular error 
return. 

The return pseudo-operation often takes the general 
form 

name RETURN locsym,i 

where locsym is the symbolic address of the associated 
save pseudo-operation, and i is the desired error 
return ( i = is the normal return ) . 

The form of the return instruction may vary. For 
example, to specify a particular error return (e.g., 2), 
the instruction 

LOG RETURN LCS,2 

is written, where lcs is the location of the save pseudo- 
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operation to be used. The following instructions are This form should also be used even where the E option 

generated: is specified if the error return is inserted into the dec- 

LOC AXT 2,4 rement of the save or saven pseudo-operation at 

SXD LCS,4 ... ft 

TRA LCS + 1 execution time. 

If the E option of the save or saven pseudo-operation The variable field of the return pseudo-operation 

is not used, the following form should be used: ma Y not be l ert blank, since it results in a tra instruc- 

RETURN LCS tion with a blank variable field. The pmc pseudo- 

which generates operation governs the listing of the instructions 

TRA LCS + 1 generated by the return pseudo-operation. 
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Part III. The Macro-Operation Facility 



Macro-operations are special types of pseudo-opera- 
tions that provide the map user with a powerful pro- 
gramming tool. After a programmer has defined a 
macro-operation, he can cause a whole sequence of 
instructions to be called into a program by coding a 
single instruction. The sequence can be repeated as 
often as desired. Moreover, any field or subfield of 
any instruction in the sequence can be changed each 
time the sequence is repeated. 

Any machine instruction, pseudo-operation, or 
macro-operation can be included in a macro-oper- 
ation. The sequence of instructions generated (usually 
called a macro-expansion) is an open subroutine. The 
instructions are executed in-line with the rest of the 
program. 

Two general requirements must be met to take 
advantage of the macro-operation facility. First, the 
macro-operation must be defined by a macro-defini- 
tion. Then, wherever the sequence of instuctions is 
desired in the program, it must be called by a macro- 
instruction. 



Defining Macro-Operations 

A macro-definition provides a name for the macro- 
operation, determines the instructions that will be in- 
cluded in the macro-expansion, and establishes the 
parts of the instructions that are to be variable. 

Three kinds of instructions must be coded to de- 
fine a macro-operation. The first is the macro pseudo- 
operation: (The card containing this instruction is 
sometimes called the macro-definition heading card.) 
Prototype instructions (sometimes called prototype 
card images) immediately follow the macro pseudo- 
operation to establish the instructions that will be 
generated in the macro-expansion. Finally, the endm 
pseudo-operation ends the macro-definition. 

The MACRO Pseudo-Operation 

The macro pseudo-operation establishes the name of 
a macro-operation. The format of the macro pseudo- 
operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


BCD name up 
to 6 characters 
long 


MACRO 


Up to 63 substitutable argu- 
ments (groups of not more 
tiirtii u ciiciictcicis ) separated 
by punctuation characters 



The name in the name field becomes the name of 
the macro-operation that is being defined. This name 
is later used to call the macro-operation and thus, in 
effect, becomes an operation code. Any valid symbol 
may be used in the name field of the macro pseudo- 
operation, or all numeric characters may be used. 
However, six zeros may not be used. 

The name in the name field of a macro pseudo- 
operation may be the same as a symbol used any- 
where in the program, even in this or any other macro- 
operation. However, if this name is the same as any 
other machine operation code, pseudo-operation code, 
or macro-operation code, the operation code is re- 
defined. 

The subfields in the variable field of the macro 
pseudo-operation contain substitutable arguments. 

SUBSTITUTABLE ARGUMENTS IN THE MACRO 
PSEUDO-OPERATION 

Much of the flexibility of the macro-operation facility 
results from the principle of substitutable arguments. 
These subfields in the variable field of the macro 
pseudo-operation are dummy names that will be re- 
placed in the macro-expansion. 

Substitutable arguments permit any field or subfield 
of any instruction to be changed each time the macro- 
operation is called. The programmer can also change 
parts of subfields and even add entire instructions. 

A substitutable argument is from one to six char- 
acters long. Any valid symbol may be used, and the 
name of a substitutable argument may consist of all 
numeric characters. For example, in the macro 
pseudo-operation 



ALPHA 



MACRO ABC, 123 



each of the two groups of three characters in the 
variable field is a substitutable argument. 

No punctuation characters except the period may be 
used as part of a substitutable argument. 

A substitutable argument may be the same as a 
symbol or an operation code, including the operation 
code for this or any other macro-operation. However, 
substitutable arguments should not be identical to 
symbols or operation codes used in the prototype that 
immediately follows unless the symbols or operation 



^A< 



ments. 



onfnnll,, 



,AcA 



\^~ oi,V.o4-i<-nfr,l->la nvrrn 
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DELIMITING SUBSTITUTABLE ARGUMENTS IN THE MACRO 
PSEUDO-OPERATION 

Substitutable arguments in the variable field of the 
macro pseudo-operation may be separated by any of 
the following punctuation (special) characters: 

= + -*/(),' 
If parentheses are used, they must be used in pairs. 

The use of these characters permits meaningful 
notation in a macro-definition. For example, 

ALPHA MACRO 23,RATE,TIME,DIST, 

QUSYM 

could also be written 

ALPHA MACRO 23(RATE*TIME = DIST) 

QUSYM 

The variable field of the macro pseudo-operation 
may be extended over more than one card by using the 
etc pseudo-operation. When the substitutable argu- 
ments appear on more than one card, the blank char- 
acter acts as a separator. Hence, no punctuation char- 
acter is needed between consecutive substitutable 
arguments that appear on separate cards. For example, 

BETA MACRO A,B,C 

could also be written 



BETA 



MACRO 
ETC 



A,B 
C 



This usage of the etc pseudo-operation differs from 
the usual case, in which all punctuation characters 
must be written. 

Consecutive punctuation characters or an explicit 
zero are ignored and do not result in a substitutable 
argument of zero. 

Prototypes in Macro-Definitions 

The prototype of a macro-definition determines the 
instructions that will be included in the macro-expan- 
sion, their sequence in the expansion, and the positions 
of the substitutable portions of the instructions. The 
prototype, which consists of one or more prototype 
instructions, immediately follows the macro pseudo- 
operation. 

A prototype instruction is similar to any other in- 
struction. It has a name field, an operation field, and 
a variable field. It may also have a comments field, 
although this field does not appear in the card image 
generated in the macro-expansion. The distinguishing 
feature of a prototype instruction is that parts of it can 
be made variable. 

The fields or subfields of a prototype instruction may 
contain text or substitutable arguments. 

text in prototypes 

Text represents the fixed parts of the instructions that 
will be generated in the macro-expansion. Any part of 



a prototype instruction that has not been made a sub- 
stitutable argument by its appearance in the variable 
field of the macro pseudo-operation is treated as text. 
For example, in the prototype 



ALPHA MACRO A,B 

CLA A 

B BUFFER 



the operation code cla and the location buffer are 
text, (buffer has been defined elsewhere in the 
program. ) 

Text is reproduced in the macro-expansion exactly 
as it appears in the prototype instruction. Thus, if only 
text is used in a field of an instruction, it must con- 
form to the rules governing that field of the instruc- 
tion in which it is used. For example, if the oper- 
ation field of a prototype instruction is text, it must 
be a valid operation code. 

Since parentheses can be used to delimit substi- 
tutable arguments within the prototype, parentheses 
must be used carefully as part of text to avoid con- 
fusing the enclosed characters with a substitutable 
argument. 

substitutable arguments in prototypes 

Substitutable arguments represent the variable parts 
of the instructions that will be generated in the macro- 
expansion. The same substitutable arguments are used 
in the prototype that appeared in the variable field of 
the macro pseudo-operation. However, in the proto- 
type, substitutable arguments appear in the fields or 
subfields of the prototype instructions that are to be 
variable. A substitutable argument may appear in any 
field or subfield of a prototype instruction. For ex- 
ample, in the sequence. 



BETA 


MACRO 


ONE,TWO,THREE 


ONE 


CLA 


PARTI 




TWO 


PART2 




STO 


THREE 



one, two, and three are substitutable arguments in 
the name, operation, and variable fields, respectively, 
of prototype instructions. 

delimiting substitutable arguments in prototypes 

The same punctuation (special) characters may be 
used in prototype instructions that were used to sep- 
arate the substitutable arguments in the variable field 
of the macro pseudo-operation. Except for the apos- 
trophe, these characters are reproduced in the macro- 
expansion. Only the aspostrophe may be used to delimit 
substitutable arguments in the variable fields of rem 



The Macro-Operation Facility 41 



and ttl pseudo-operations and the data subfields of bci 
pseudo-operations. (Another use of the apostrophe in 
macro-operations is explained in the section "Com- 
bining Substitutable Arguments and Text.") 

A comma or a left parenthesis immediately follow- 
ing the operation code (as near the beginning of the 
card as column 11) signifies the end of the operation 
field and the beginning of the variable field. 

A blank delimits a substitutable argument in a pro- 
totype. For example, in the macro-definition (where 
b represents a blank) 



XYZ 



MACRO 
AbbbB 



A,B,C 



three blanks separate A (in the operation field) from 
B (in the variable field). It is not always necessary 
that three blanks separate these two fields, but at 
least three characters are used for an operation field 
code. In this example, A and two blanks are used, 
whereas the third blank is required to terminate the 
operation field. If fewer blanks separated A from B, 
both would be taken as part of the operation code, 
causing errors. 

If a blank is encountered before card column 72 
in the variable field of a prototype instruction other than 
a bci, rem, or ttl pseudo-operation, the card is termi- 
nated. Substitutable arguments may appear anywhere 
from column 1 through column 72 on bci, rem, and 
ttl cards. Any information to the right of the blank will 
not be included in the macro-definition. 

If a bci, ttl, or rem pseudo-operation has been re- 
defined in a macro-definition or by an operation- 
defining pseudo-operation, it should not be used within 
a macro-definition. Also, if an operation code has been 
defined to have the effect of a bci, ttl, or rem pseudo- 
operation and is used within a macro-definition, the 
variable field will be terminated by a blank. 

Every field or subfield of six or fewer characters in 
any field of a prototype instruction is compared with 
the substitutable arguments in the variable field of 
the macro pseudo-operation. Therefore, care must be 
taken to avoid confusing fields intended as text with 
fields intended as substitutable arguments. 

Remarks cards having an asterisk in column 1 may 
be included in macro-definitions, but they cause a 
warning message to be issued. 

The EN DM Pseudo-Operation 

The endm pseudo-operation terminates a macro- 
definition. The format of the endm pseudo-operation is : 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ENDM 


Either: 

1. One or two subfields, sep- 
arated by a comma, or 

2. Blanks 



The endm pseudo-operation immediately follows the 
last prototype instruction and ends the macro-defini- 
tion. An endm pseudo-operation is required for every 
macro pseudo-operation. 

The first of the two subfields permitted in the 
variable field of the endm pseudo-operation is a bcd 
name of up to six characters. If a name is used in this 
subfield, it must be the same as the name used for the 
corresponding macro pseudo-operation. If the first 
subfield is not used, but the second is, a comma must 
precede the second subfield. 

If the second subfield in the variable field of the 
endm pseudo-operation is present, it specifies either 
crs ( create symbols ) or nocrs ( no created symbols ) . 
The second subfield controls symbol creation for this 
macro-operation only, overriding the effect of the 
nocrs and orgcrs pseudo-operations (see the section 
"Created Symbols" ) . crs in this subfield always causes 
and nocrs always suppresses symbol creation each 
time the macro-operation is called. Any symbol other 
than crs or nocrs has no effect. 

For example, in the macro-definition 

ALPHA 



MACRO 


A,B 


CLA 


A 


ADD 


B 


STO 


SUM 


ENDM 


ALPHA,NOCRS 



the endm pseudo-operation is coded so that symbol 
creation is suppressed whenever this macro-operation 
is called. 

If the variable field or the first subfield of the 
variable field is blank, this and all unterminated macro- 
definitions are terminated (see the section "Nested 
Macro-Operations" ) . 



Calling Macro-Operations 

After a macro-operation has been defined, it may be 
called so that the generated sequence of instructions 
is brought into a program at a desired point. In the 
macro-expansion, eacn prototype instruction in the 
macro-definition is reproduced. Text and all punctua- 
tion characters except the apostrophe are reproduced 
exactly as they appeared in the prototype. However, 
the substitutable arguments that appeared in the varia- 
ble field of the macro pseudo-operation and in the 
prototype are replaced by the actual parameters that 
the programmer wishes to appear in the expansion. 
These parameters are provided in the macro-instruc- 
tion, which is used to call the macro-operation. 

The Macro-Instruction 

The macro-instruction calls a previously defined 
macro-operation into a program. The format of the 
macro-instruction is: 
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NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


1. A symbol, or 

2. Blanks 


Macro- 
operation 
name 


Parameters, separated by 
commas or parentheses 



If there is a symbol in the name field, it is assigned to 
the first instruction of the macro-expansion. 

The name that was assigned in the name field of the 
maceo pseudo-operation is an operation code and is 
used in the operation field of the macro-instruction. 

The variable field of the macro-instruction contains 
the actual parameters that the programmer wishes to 
appear in the macro-expansion. 

PARAMETERS IN MACRO-INSTRUCTIONS 

The parameters in the variable field of the macro- 
instruction replace the substitutable arguments that 
appeared in the macro-definition. These parameters 
must appear in the same order as the substitutable 
arguments they are to replace originally appeared in 
the variable field of the macro pseudo-operation. 

The length of a parameter in the variable field of a 
macro-instruction is not limited to six characters as is a 
substitutable argument. The variable field of a macro- 
instruction may be extended over more than one card 
by using the etc pseudo-operation. However, a single 
parameter must appear completely on one card unless 
it is enclosed in parentheses. 

Macro-instruction parameters consist of any appro- 
priate character or group of characters that would 
normally appear in the particular instruction. For ex- 
ample, in the macro-definition. 



QPOLY 


MACRO 


COEFF,LOOP,DEG,T,OP 




AXT 


DEG,T 




LDQ 


COEFF 


LOOP 


FMP 


GAMMA 




OP 


COEFF + DEG + 1.T 




XCA 






TIX 


LOOP,T,l 




ENDM 


QPOLY 



mnemonic symbols represent the substitutable argu- 
ments, loop appears in a name field, op in an operation 
field, and coeff, deg, and T appear in subfields of the 
variable field, gamma is text and not a substitutable 
argument, since it does not appear in the variable field 
of the macro pseudo-operation. In this macro-instruc- 
tion, a symbol should be substituted for loop and a 
valid operation code for op. Such a macro-instruction 
might be written 



X015 



QPOLY CI - 4,FIRST,5,4,FAD 



The macro-expansion would cause the following 
six card images to be generated. 



X015 



AXT 
LDQ 



5,4 
Cl-4 



FMP 


GAMMA 


FAD 


CI -4 + 5 + 1,4 


XCA 




TIX 


FIRST,4,1 



FIRST 



The symbol xoio is assigned to the first instruction, 
and each substitutable argument is replaced by the 
corresponding parameter that appeared in the variable 
field of the macro-instruction. 

DELIMITING MACRO-INSTRUCTION PARAMETERS 

The parameters in the variable field of a macro- 
instruction are separated either by commas or paren- 
theses. A single comma following a right parenthesis 
or preceding a left parenthesis is redundant and may 
be omitted. Neither of these combinations results in a 
null parameter. A null parameter is indicated by two 
consecutive commas or by a single comma at the be- 
ginning of the variable field. If the blank terminating 
the variable field is preceded by a comma, the last 
subfield is not null (see the example in the section 
"Created Symbols" ) . An explicit zero must be used to 
obtain a zero parameter. 

Parentheses around data used as a macro-instruction 
parameter signify that everything within the paren- 
theses, including blanks, is to replace the correspond- 
ing substitutable argument in the prototype. (In fact, 
if blanks are to be included in a macro-instruction 
parameter, the parameter must be enclosed in paren- 
theses. ) For example, the macro-definition 



XYZ 

B 



MACRO 
A 



A,B 
ENDM XYZ 



followed by the macro-instruction 



XYZ 

ETC 



results in the expansion 



ALPHA 



AXT 
TRA 



(AXTbbbbblO,l) 

( ALPHAbbTRAbbbbbBETA,!) 



10,1 
BETA,! 



If parentheses are to appear in a macro-expansion, 
they must be enclosed in an outer pair of parentheses. 
The outer parentheses are removed in the expansion. 

Pairs of parentheses must be balanced. For example, 
given the macro-definition 



CALLIO 


MACRO 


IOCOM,Tl,OP,LABEL,T2 




ETC 


TAPNO,PFX,ERRET 




TSX 


(TAPE), 4 




PZE 


IOCOM,Tl,OP 




PZE 


LABEL,T2,TAPNO 




IFT 


ERRET=1 




PFX 


ERRET 




ENDM 


CALLIO 



and using the following parameters in place of the 
substitutable arguments 
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IOCOM - CITIO 

Tl — 2 

op-1rbep) 
label - citlb 



T2 - null 

TAPNO — CITTAP 
PFX - null 
ERRET - null 



the corresponding macro-instruction would be 

CALLIO ClTIO,2, ( ( RBEP ) ) ,CITLB 
ETC ,CITTAP„, 

This macro-instruction could also be written 

CALLIO CITIO,2 ( ( RBEP ) ) CITLB 
ETC ,CrTTAP„, 

since the commas around ( ( rbep ) ) are redundant. 
Note that tape must not be a substitutable argument 
and that (rbep) must be enclosed in outer parentheses. 
Also, an explicitly null parameter appears in the macro- 
instruction at a position corresponding to the substi- 
tutable argument erret in the macro-definition. This 
null parameter causes the fifth word of the expansion 
to be omitted. 

Inserting Instructions into Macro-Expansions 

A single parameter in a macro-instruction may include 
more than one field or even an entire instruction to 
replace a single substitutable argument that appeared 
in a field of a prototype instruction. The parameter is 
inserted into the field in which the original substituta- 
ble argument appeared, and it may extend to other 
fields to the right of the field in which it is inserted. 
For example, if a substitutable argument appeared in 
the operation field of a prototype instruction, a parame- 
ter could be inserted that would have an operation 
field and a variable field. 

When a parameter consists of more than one field 
or is an entire instruction, the programmer must pro- 
vide enough blanks in the parameter so that the fields 
of the instruHh'nn annear in their nroner nositions in 
the macro-expansion. 

In the following example, a substitutable argument 
in the operation field of a prototype instruction is re- 
placed by an instruction having an operation field and 
a variable field. The macro-definition. 

XYZ MACRO A,B,C, 

CLA A 
B 

STO C 

ENDM XYZ 

followed by the macro-instruction 

SUM 



XYZ 
ETC 



ALPHA ( ADDbbbbbBETA ) 
GAMMA 



results in the macro-expansion 



CLA 
ADD 
STO 



ALPHA 

BETA 

GAMMA 



Conditional Assembly in Macro-Operations 

The ift and iff pseudo-operations may be used to de- 



termine whether instructions within a macro-expansion 
are assembled. For example, the sequence 



ADDM 



MACRO 

CLA 

ADD 



S'l'U 



B,C,D 

B 

C 

/T\ I / A /-■ / 

/ YJI — / rw^ti 

D 



allows the sum to be stored if the name substituted for 
D is not literally the characters ac and prevents it 
from being stored if the name is the characters ac. 

If the iff pseudo-operation in the above example 
were replaced by 



IFT 



D = l 



the sum would be stored only if the parameter substi- 
tuted had already appeared in the name field of some 
instruction (i.e., if the S-value of D is 1). 

The two conditions can be combined to obtain 



IFF 
IFT 



/D/ = /AC/,AND 
D = l 



which assembles the store operation only if D is not 
literally ac and has appeared before in a name field. 

Combining Substitutable Arguments and Text 

The apostrophe can be used to combine substitutable 
arguments and text to form a single prototype subfield. 
The apostrophe delimits a substitutable argument in a 
macro-definition prototype but is not itself included in 
the macro-expansion. However, the apostrophe may not 
be used to combine partial subfields in lower-level 
nested macro-definitions (see the section "Nested 
Macro-Operations" ) . 

For example, given the macro-definition 

ALPHA 



MACRO 


A,B,C 


BCI 


A,bb'B'bERROR,b 




CONDITION'C'b 




IGNORED 


ENDM 


ALPHA,NOCRS 



the macro-instruction 

ALPHA fi,( FIELD )„ 

causes the following instruction to be generated: 

BCI 6,bbFIELDbERROR,b 

CONDITIONb 

IGNORED 

By using the apostrophe, instructions within macro- 
operations can be altered and even name field symbols 
can be changed. For example, the macro-definition 

FXCY 
N'B 



MACRO 


B,W,Z,Y,T 


PXA 


Y,T 


PAC 


0,4 


'W'X'Z 


Y,4 


ENDM 


FXCY 



aiter me macro-msirucuon 

FXCY AME,S,A,DATA,1 
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results in the sequence 



NAME 



PXA 
PAC 
SXA 



DATA,1 

0,4 

DATA,4 



The name field may not exceed six characters in the 
prototype, including substitutable arguments, text, and 
punctuation characters. The operation field may not 
exceed six characters or six characters and an asterisk. 

Nested Macro-Operations 

A macro-definition may be included completely within 
the prototype of another higher-level macro-definition. 
When the higher-level macro-operation is expanded, 
the macro pseudo-operation and the prototype of the 
lower-level macro-operation are generated. Thus, a 
macro-instruction for a lower-level macro-operation 
cannot be used until all higher -level macro-operations 
have been expanded. 

A new macro-operation may be defined or an existing 
macro-operation redefined, depending on whether the 
name of the lower-level macro-operation appears as text 
or as a substitutable argument in the higher-level 
macro-operation. For example, in the macro-definition 

MAC1 MACRO MAC2,ALPHA,BETA 

ETC GAMMA,DELTA 

MAC2 MACRO ALPHA 

BETA A 

GAMMA B 

DELTA C 

ENDM MAC2 

ENDM MAC1 

the lower-level macro-operation, mac2, appears as a 
substitutable argument. The macro-instruction 

MAC1 ABC,(A,B,C),CLA,ADD,STO 

generates 

ABC MACRO A,B,C 



CLA 


A 


ADD 


B 


STO 


C 


ENDM 


ABC 



which defines a macro-operation, abc, where A, B, and 
C are substitutable arguments; and cla, add, and sto 
are text. 

However, had mac2 appeared as text rather than as a 
substitutable argument in the macro-definition of maci, 
mac2 would be redefined each time maci was ex- 
panded. 

There is no significant limit to the depth of nesting 
permitted. 

Macro-Instructions in Macro-Definitions 

The prototype of a macro-definition may include 
macro-instructions for which macro-operations have 
not yet been defined. However, these macro-instruc- 
tions must be defined before using a macro-instruction 
that expands the macro-operation. Circular definition 



must be avoided. For example, a macro-operation, A, 
may not include a macro-instruction for A. Also, a 
macro-operation may not include its own macro- 
instruction within the prototype. 

Data enclosed within parentheses may be used as a 
parameter in a macro-instruction. When a macro- 
instruction is used within another macro-definition, 
special handling of data containing blanks is required. 
Such data must be replaced by a substitutable argu- 
ment in the outer macro-definition. The actual data 
must appear as a parameter in the macro-instruction. 
An additional pair of parentheses must surround the 
data (already within a single pair of parentheses) to 
ensure proper substitution. 

For example, in the macro-definition 



MACI 



MACRO 

CLA 

MAC 

STO 

ENDM 



A,C 
C 

A,(AXTbb**,4b) 

A 

MACI 



mac is a previously defined macro-operation. Proper 
substitution would not occur, because a blank termin- 
ates the variable fields of prototype instructions except 
for the bci, rem, and ttl pseudo-operations. Instead, 
the following sequence should be used: 

MACI 



MACRO 


A,C,D 


CLA 


C 


MAC 


A,D 


STO 


A 


ENDM 


MACI 



When using the macro-instruction maci, the substitu- 
tion would be 

MACI X,Y,( ( AXTbb**,4b ) ) 

j. ne resulting genera iCQ sequence is 



CLA 
MAC 
STO 



X,(AXTbb**,4b) 
X 



The macro-instruction for mac can now cause the data 
to be substituted properly. 

Qualification Within Macro-Operations 

The qualification in effect when the macro-instruction 
is used will be used for symbols in the macro-expansion. 
If a qualification symbol is required within a macro- 
definition, it may be a substitutable argument, as may 
the symbols it qualifies. 

If a macro-expansion having a qualified section falls 
within the range of a qualified section in the program, 
the rules for nested qualification apply when referring 
to symbols within the macro-expansion. 

Macro-Related Pseudo-Operations 

The irp pseudo-operation is used to supplement the 
definition of macro-operations, whereas orgcrs and 
nocrs are used in macro-expansions. 
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The IRP Pseudo-Operation 

The irp ( Indefinite Repeat ) pseudo-operation causes a 
sequence of instructions within a macro-operation to be 
repeated with one parameter varied at each repetition. 
The format of the irp pseudo-operation is: 



generates 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


IRP 


1 . A single substitutable argu- 
ment, or 

2. Blanks 



To repeat a sequence of instructions, two irp pseudo- 
operations are required within a macro-definition — one 
to initiate the sequence and the other to end it. A single 
substitutable argument that originally appeared in the 
variable field of the preceding macro pseudo-operation 
must appear in the variable field of the initial irp 
pseudo-operation. The variable field of the second irp 
pseudo-operation is left blank. 
For example, the operation 

IRP A 

initiates a sequence, whereas 

IRP 

ends the sequence. 

Substitutable argument A governs the iteration of the 
instructions. If a symbol other than a single substitu- 
table argument or more than one subfield appears in 
the variable field of the first mp pseudo-operation, the 
pseudo-operation is ignored and a warning message is 
issued. 

In the macro-instruction, substitutable argument A 
is replaced by one or more subarguments enclosed in 
parentheses and separated by commas. Each time the 
macro-instruction is used, the assembly program gener- 
ates the sequence of instructions with each of the sub- 
arguments used successively in place of substitutable 
argument A. If only one subargument is used, the 
sequence of instructions will be generated only once. 
If no subarguments are given, the whole sequence will 
be skipped. If a blank appears within the parentheses, 
only the arguments to the left of the blank will be effec- 
tive. For example, given the macro-definition 



XYZ 



MACRO ARG.B 

IRP ARG 

CLA ARG 

ADD B 

STO ARG 

IRP 

ENDM XYZ 



the macro-instruction 



XYZ 



J 

CONST > (First iteration, with 

j ) subargument J) 

K } 

r ONST*- 'Second iteration with 

K i subargument K) 

L / 

CONST WThird iteration, with 

L I subargument L) 

If the substitutable argument does not appear be- 
tween the two irp pseudo-operations, the generated 
sequences will be identical, their number depending on 
the number of subarguments given. 

For example, given the macro-definition 

BBB 



CLA 
ADD 
STO 
CLA 
ADD 
STO 
CLA 
ADD 
STO 



MACRO 


C,D,E 


IRP 


C 


CLA 


D 


STO 


E 


IRP 




ENDM 


BBB 



the macro-instruction 



BBB 



( 1,2,3 ),DATA1,DATA2 



generates 



CLA 


DATA1 


STO 


DATA2 


CLA 


DATA1 


STO 


DATA2 


CLA 


DATA1 


STO 


DATA2 



An irp pseudo-operation may not occur explicitly 
within the range of another irp. Such a nested pair 
causes termination of the first range and opening of a 
second range. However, a macro-instruction within the 
range of an irp pseudo-operation may itself cause pairs 
of irp pseudo-operations to be generated at a lower 
level. 

Created Symbols 

If parameters are missing from the end of the variable 
field of the macro-instruction, symbols are created to 
fill the vacancies. These symbols take the form 

..0001 
..0002 



No created symbols are supplied for an explicitly null 
argument. Created symbols are supplied only at the end 
of the parameters. 
For example, if the macro pseudo-operation 



ALPHA 



MACRO A,B,C 



r~u — ,„j L-. j-i .• . 



(J,K,L), CONST 



ALPHA 



X„ 
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substitutable argument A is replaced by X, substitu- 
table argument B is omitted since the parameter is ex- 
plicitly void, and substitutable argument C is replaced 
by a symbol of the form . . nnnn. This symbol is created 
to replace the omitted parameter at the end of the 
variable field of the macro-instruction. 
Given the macro-definition 



XFAD 



MACRO N,B,C,D,E,A,X 





SXA 


A,4 




AXT 


N,4 


X 


CLA 


B,4 




IFF 


10,1=11 




re 


D,4 




STO 


E,4 




TIX 


X,4,l 


A 


AXT 


**A 




ENDM 


XFAD.CRS 


the macro-instruction 






XFAD 


4,DATA,AD,DAT 


generates 








SXA 


..0001,4 




AXT 


4,4 


..0002 


CLA 


DATA,4 




FAD 


DATA1,4 




STO 


DATA2,4 




TIX 


..0002,4,1 ' 


..0001 


AXT 


**,4 


However, the 


macro-instruction 




XFAD 


4,DATA,„DATA2 


generates 








SXA 


..0001,4 




AXT 


4,4 


..0002 


CLA 


DATA,4 




STO 


DATA2,4 




TIX 


..0002,4,1 


..0001 


AXT 


**,4 



In this example, the number of instructions can vary 
between references, making a relative-address refer- 
ence difficult. However, by permitting the assembly 
program to generate the names, the references are cor- 
rect without requiring programmer-specified names. 

The NOCRS Pseudo-Operation 

The nocrs pseudo-operation suppresses symbol crea- 
tion, which causes missing parameters at the end of the 
variable field of the macro-instruction to be treated as 
if they were explicitly null. The format of the nocrs 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FDZLD 


Blanks 


NOCRS 


Ignored 



The ORGCRS Pseudo-Operation 

The ORGCRS pseudo-operation may be used to alter the 
form of created symbols. This pseudo-operation also 
causes symbol creation to be resumed if it has been 
suppressed by a nocrs. The format of the orgcrs 
pseudo-operation is: 



NAME FIELD 


OPERATION 
FIELD 


VARIABLE FIELD 


Blanks 


ORGCRS 


1. Blanks, or 

2. Up to 4 numeric digits, or 

3. One BCD character and 
up to 4 numeric digits. 



If a bcd character appears in the variable field, it re- 
places the second period of the created symbols. If dig- 
its appear, they will be the origin of the new set of 
created symbols. This origin will be one lower than the 
first symbol actually created. If fewer than four digits 
are used, they will be right-justified with leading zeros. 
If no digits are supplied or if the variable field is blank, 
the number will continue from the last created symbol. 

With a blank variable field, the orgcrs pseudo-opera- 
tion causes resumption or continuation of symbol 
creation. 

The PURGE Pseudo-Operation 

The purge pseudo-operation removes from core stor- 
age prototypes of macro-operations that are no longer 
needed, thus providing space for other prototypes. 
However, the purge pseudo-operation does not remove 
the name of the macro-operation from the name table. 
The format of the purge pseudo-operation is: 



NAME FDZLD 


OPERATION 
FD3LD 


VARIABLE FD3LD 


Blanks 


PURGE 


A list of macro-operation names, 
separated by commas 



If an entry in the variable field of a purge pseudo- 
operation is not the name of a macro-operation, it is 
ignored and no message is issued. 

If a macro-operation is redefined, purging of the 
previous form is automatic ( a purge pseudo-operation 
is not needed ) . 

If a call is made to a purged macro-operation, the 
call will be ignored and an error message will be issued. 
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Appendixes 



Appendix A: Machine Operations 

All machine operations recognized by map are tabu- 
lated in this appendix, including supplementary infor- 
mation about their format and use. Listings are pro- 
vided of the 7090 machine operations, extended 
machine operations, special operations, 7094 machine 
operations, 7909 data channel commands, 1301 disk file 
orders, and 7340 Hypertape orders. 

The code letters used under identical column head- 
ings have the same significance in all tables. The bcd 
name of the machine operation is given in the column 
headed Mnemonic. 

Type indicates machine-instruction format character- 
istics by code letters having the following meanings: 



CODE 


MEANING 


A 


15-bit decrement field 


B 


No decrement field 


C 


8-bit decrement field 


D 


18-bit address field 


E 


13-bit address field 


K 


4-bit prefix field 


L 


Disk orders 



The codes in the address ( Addr ) , tag, and decrement 
(Deer) columns signify: 

CODE MEANING 

R Subfield required. If missing, error message 

FIELD REQUIRED is issued. 

P Subfield permitted. Neither its presence nor 

absence results in a message. 
U( n ) Subfield unexpected. If present, message FIELD 

NOT EXPECTED is issued. Assembly program 
truncates definition value of subfield to number 
of bits (n) shown in parentheses and, treating 
this value as a constant, adds it to value nor- 
mally appearing in subfield. 

N Subfield not allowed. If present and its value 

is not zero, message FIELD NOT ALLOWED 
is issued. Its value is always treated as a con- 
stant zero. 

If the size of a subfield differs from normal, field size is 
indicated in parentheses following the subfield letter 
code. 

In the column headed Ind, the letter (P) indicates 
that indirect addressing is permitted and ( N ) indicates 
that is is not permitted. 

7090 Machine Operations 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


ACL 


B 


R 


P 


U(4) 


P 


ADD 


B 


R 


P 


U(4) 


P 


ADM 


B 


R 


P 


U(4) 


P 


ALS 


B 


R 


P 


U(6) 


N 


ANA 


B 


R 


P 


U(4) 


P 


ANS 


B 


R 


P 


U(4) 


P 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


ARS 


B 


R 


P 


U(6) 


N 


AXC 


B 


R 


R 


U(6) 


N 


AXT 


B 


R 


R 


U(6) 


N 


BSF 


B 


R 


P 


U(6) 


N 


BSR 


B 


R 


P 


U(6) 


N 


BTT 


E 


R 


P 


U(6) 


N 


CAL 


B 


R 


P 


U(4) 


P 


CAQ 


C 


R 


P 


R(8) 


N 


CAS 


B 


R 


P 


U(4) 


P 


CHS 


E 


N 


P 


U(6) 


N 


CLA 


B 


R 


P 


U(4) 


P 


CLM 


E 


N 


P 


U(6) 


N 


CLS 


B 


R 


D 

X 


U(4) 


P 


COM 


E 


N 


P 


U(6) 


N 


CRQ 


C 


R 


P 


R(8) 


N 


CVR 


C 


R 


P 


R(8) 


N 


DCT 


E 


N 


P 


U(6) 


N 


DVH 


B 


R 


P 


U(4) 


P 


DVP 


B 


R 


P 


U(4) 


P 


ECTM 


E 


N 


P 


U(6) 


N 


EFTM 


E 


N 


p 


U(6) 


N 


ENB 


B 


R 


P 


U(4) 


P 


ENK 


E 


N 


P 


U(6) 


N 


ERA 


B 


R 


P 


U(4) 


P 


ESNT 


B 


R 


P 


U(4) 


P 


ESTM 


E 


N 


P 


U(6) 


N 


ETM 


E 


N 


P 


U(6) 


N 


ETT 


E 


R 


P 


U(6) 


N 


FAD 


B 


R 


P 


U(4) 


P 


FAM 


B 


R 


P 


U(4) 


P 


FDH 


B 


R 


P 


U(4) 


P 


FDP 


B 


R 


P 


U(4) 


P 


FMP 


B 


R 


P 


U(4) 


P 


FRN 


E 


N 


P 


U(6) 


N 


FSB 


B 


R 


P 


U(4) 


P 


FSM 


B 


R 


P 


U(4) 


P 


HPR 


B 


P 


P 


U(6) 


N 


HTR 


B 


R 


p 


U ( 4 ) 


p 


IIA 


B 


P 


P 


U(6) 


N 


IIL 


D 


R(18) 


N 


U(6) 


N 


IIR 


D 


R(18) 


N 


U{6) 


N 


IIS 


B 


R 


P 


U(4) 


P 


IOT 


E 


N 


P 


U(6) 


N 


IOCD 


A 


R 


N 


R 


P 


IOCP 


A 


R 


N 


R 


P 


IORP 


A 


R 


N 


R 


P 


IOCT 


A 


R 


N 


R 


P 


IORT 


A 


R 


N 


R 


P 


IOSP 


A 


R 


N 


R 


P 


IOST 


A 


R 


N 


R 


P 


LAC 


B 


R 


R 


JUR\ 


N 


LAS 


B 


R 


P 


U(4) 


P 


LBT 


E 


N 


P 


U(6) 


N 


LCHx 


B 


R 


P 


U(4) 


P 


LDC 


B 


R 


R 


U(6) 


N 


LDI 


B 


R 


P 


U(4) 


P 


LDQ 


B 


R 


P 


U(4) 


P 


LFT 


D 


R(18) 


N 


U(6) 


N 


LFTM 


E 


N 


P 


U(6) 


N 


LGL 


B 


R 


P 


U(6) 


N 


LGR 


B 


R 


P 


U(6) 


N 


LLS 


B 


R 


P 


U(6) 


N 


LNT 


D 


R(18) 


N 


U(6) 


N 


LRS 


B 


R 


P 


U(6) 


N 
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MNEMONIC 

LSNM 

LTM 

LXA 

LXD 

MPR 

MPY 

MSE 

NOP 

NZT 

OAI 

OFT 

ONT 

ORA 

ORS 

OSI 

PAC 

PAI 

PAX 

PBT 

PDC 

PDX 

PIA 

PSE 

PXA 

PXD 

RCHx 

RCT 

RDCx 

RDS 

REW 

RFT 

RIA 

RIL 

RIR 

RIS 

RND 

RNT 

RQL 

RUN 

SBM 

SCHx 

SDN 

SIL 

SIR 

SLQ 

SLW 

SSM 

SSP 

STA 

STD 

STI 

STL 

STO 

STP 

STQ 

STR 

STT 

STZ 

SUB 

SXA 

SXD 

TCH 

TCNx 

TCOx 

TEFx 

TIF 

TIO 

TIX 

TLQ 

TMI 

TNO 

TNX 



TYPE 
E 

E 
B 
B 
B 
B 
E 
B 
B 
B 
B 
B 
B 
B 
B 
B 
B 
B 
E 
B 
B 
B 
E 
B 
B 
B 
E 
E 
B 
B 
D 
B 
D 
D 
B 
E 
D 
B 
B 
B 
B 
B 
D 
D 
B 
B 
E 
E 
B 
B 
B 
B 
B 
B 
B 
A 
B 
B 
B 
B 
B 
A 
B 
B 
B 
B 
B 
A 
B 
B 
B 
A 



ADDR 

N 

N 

R 

R 

R 

R 

R 

P 

R 

P 

R 

R 

R 

R 

R 

P 

P 

P 

N 

P 

P 

P 

R 

P 

P 

R 

N 

N 

R 

R 

R(18 

P 

R(18 

R(18 

R 

N 

R(18 

R 

R 

R 

R 

R 

R(18 

R(18 

R 

R 

N 

N 

R 

R 

R 

R 

R 

R 

R 

P 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 



TAG 
P 
P 
R 
R 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 

R 

p 

R 
P 
R 
R 
P 
P 
R 
R 
P 
P 
P 
P 
P 
N 
P 
N 
N 
P 
P 
N 
P 
P 
P 
P 
P 
N 
N 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
P 
R 
R 
N 
P 
P 
P 
P 
P 
R 
P 
P 
P 
R 



DECR 
U 



IND 

N 
N 
N 
N 
P 
P 
N 
N 
P 
N 
P 
P 
P 
P 
P 
N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
P 
N 
N 
N 
N 
N 
N 
N 
N 
P 
N 
N 
N 
N 
P 
P 
N 
N 
N 
P 
P 
N 
N 
P 
P 
P 
P 
P 
P 
P 
N 
P 
P 
P 
N 
N 
P 
P 
P 
P 
P 
P 
N 
P 
P 
P 
N 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


TNZ 


B 


R 


P 


U(4) 


P 


TOV 


B 


R 


P 


U(4) 


P 


TPL 


B 


R 


P 


U(4) 


P 


TQO 


B 


R 


P 


U(4) 


P 


TQP 


B 


R 


P 


U(4) 


P 


TRA 


B 


R 


P 


U(4) 


P 


TRCx 


B 


R 


P 


U(4) 


P 


TSX 


B 


R 


R 


U(6) 


N 


TTR 


B 


R 


p 


U(4) 


P 


TXH 


A 


R 


R 


R 


N 


TXI 


A 


R 


R 


R 


N 


TXL 


A 


R 


R 


R 


N 


TZE 


B 


R 


P 


U(4) 


P 


UAM 


B 


R 


P 


U(4) 


P 


UFA 


B 


R 


P 


U(4) 


P 


UFM 


B 


R 


P 


U(4) 


P 


UFS 


B 


R 


P 


U(4) 


P 


USM 


B 


R 


P 


U(4) 


P 


VDH 


C 


R 


P 


R(6) 


P 


VDP 


C 


R 


P 


R(6) 


P 


VLM 


C 


R 


P 


R(6) 


P 


WEF 


B 


R 


P 


U(6) 


N 


WRS 


B 


R 


P 


U(6) 


N 


XCA 


B 


P 


P 


U(6) 


N 


XCL 


B 


P 


P 


U(6) 


N 


XEC 


B 


R 


P 


U(4) 


P 


ZET 


B 


R 


P 


U(4) 


P 



Extended Operations 

map provides a group of sense and select-type extended 
operation codes for programmer convenience. These 
codes permit the address portion of certain instructions 
to be specified symbolically as part of the operation 
code, rather than octally in the address portion of the 
instruction. These codes also provide more meaningful 
mnemonics for some machine instructions. 

map also recognizes a group of prefix codes that can 
be used in such programming applications as forming 
constants or in subroutine calling sequences. 

SENSE TYPE 

The following extended operation codes of the sense 
type are recognized by the assembly program. The tag 
subfield is permitted in all these operation codes, but 
indirect addressing is not permitted in any of them. 
The letter x is to be replaced by one of the channel 
letters. 



MNEMONIC 

BTTx 

ETTx 

SLF 

SLN 

SLT 

SPRx 

SPTx 

SPUx 

SWT 

SELECT TYPE 



ADDR 

N 
N 
N 
R 
R 
R 
N 
R 
R 



DECR 

U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 
U(6) 



The following extended operation codes of the select 
type are recognized by the assembly program. The tag 
subfield is permitted in all these operation codes, but 
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indirect addressing is not permitted in any of tnem. 

deck, the address field must contain an integer or an 
immediate symbol. The letter x is to be replaced by a 
channel letter. 



MNEMONIC 


ADDR 


DECR 


BSRx 


R 


U(6) 


BSFx 


R 


U(6) 


RCDx 


N 


U(6) 


REWx 


R 


U(6) 


RPRx 


N 


U(6) 


RTBx 


R 


U(6) 


RTDx 


R 


U(6) 


RUNx 


R 


U(6) 


SDHx 


R 


U(6) 


SDLx 


R 


U(6) 


WEFx 


R 


U(6) 


WPBx 


N 


U(6) 


WPDx 


N 


U(6) 


WPUx 


N 


U(6) 


WTBx 


R 


U(6) 


WTDx 


R 


U(6) 


PREFIX CODES 







The following prefix codes are recognized by the as- 
sembly program. All have 15-bit decrement fields 
(Type A) with address, tag, and decrement permis- 
sible. Indirect addressing is permitted for all prefix 
codes. 



MNEMONIC 


MEANING 


PREFIX 


FIVE 


Five 


5 


FOR 


Four 


4 


FOUR 


Four 


4 


FVE 


Five 


5 


MON 


Minus One 


5 


MTH 


Minus Three 


7 


MTW 


Minus Two 


6 


MZE 


Minus Zero 


4 


ONE 


One 


1 


PON 


Plus One 


1 


PTH 


Plus Three 


3 


PTW 


Plus Two 


2 


PZE 


Plus Zero 





SEVEN 


Seven 


7 


SIX 


Six 


6 


SVN 


Seven 


7 


THREE 


Three 


3 


TWO 


Two 


2 


ZERO 


Zero 






Special Operations 

The following special operations recognized by map 
reduce coding effort for frequently occurring condi- 
tions. Indirect addressing is not permitted in any of 
these operations. 



MNEMONIC TYPE 



BFT 
BNT 
BRA 



IIB 

RIB 

SIB 

ZAC 

ZSA 

ZSD 



D 
D 
A 
A 
A 
A 
D 
D 
D 

r» 

B 
B 



TAG 

N 
N 
N 
P 
P 
P 
N 
N 
N 
N 
N 
N 



DECR 

N 
N 
P 
P 
P 
P 
N 
N 
N 



ASSEMBLES 
AS 

LFT(RFT) 

LNT(RNT) 

TXL 

PZE 

PZE 

PZE 

IIL(HR) 

RIL(RIR) 

SIL(SIR) 



(See the section "The bjbool and lbool Pseudo- 
vyperations ior a uescription of special type E) in- 
structions. ) 

7094 Machine Operations 

■n r _11 • <lrv\ a i. ■_.... ■ • . i 

a iic luiiuwmg /u»<± inacnme operations are recognized 
by map. In a 7090 assembly, these operations are re- 
placed by system macro-instructions (see Appendix 
B ) with the exceptions noted below. The 7090 system 
macro-instructions closely approximate the effects of 
the 7094 machine operations but may cause slight 
differences in the precision of the results obtained. 

If a subfield is to be supplied at execution time, the 
notation ** must be used. The field may not be left 
blank. 



MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


DFAD 


B 


R 


P 


U(4) 


P 


DFAM 


B 


R 


P 


U(4) 


P 


DFDH 


B 


R 


P 


U(4) 


P 


DFDP 


B 


R 


P 


U(4) 


P 


DFMP 


B 


R 


P 


U(4) 


P 


DFSB 


B 


R 


P 


U(4) 


P 


DFSM 


B 


R 


P 


U(4) 


P 


DLD 


B 


R 


P 


U(4) 


P 


DST 


B 


R 


P 


U(4} 


P 


*DUAM 


B 


R 


P 


U(4) 


P 


*DUFA 


B 


R 


P 


U(4) 


P 


*DUFM 


B 


R 


P 


U(4) 


P 


*DUFS 


B 


R 


P 


U(4) 


P 


*DUSM 


B 


R 


P 


U(4) 


P 


*EMTM 


E 


N 


P 


U(6) 


N 


*LMTM 


E 


N 


P 


U(6) 


N 


MrK-iJ*. 


B 


P 


R 


U(8) 


N 


PCD 


B 


P 


R 


U(6) 


N 


SCA 


B 


R 


R 


U(6) 


N 


SCD 


B 


R 


R 


U(6) 


N 



*These 7094 instructions are not replaced by macro-instructions 
when assembling in the 7090 mode; they are assembled as 
NOP instructions, and a low-severity message is issued. 



IBM 7909 Data Channel Commands 

The following 7909 data channel commands are recog- 
nized by the assembly program. An x in the operation 
code is to be replaced by a channel letter. 



TT/«\ DVT\ 

U(6) SXA 
U(6) SXD 



MNEMONIC 

CPYD 

CPYP 

CTL 

CTLR 

CTLW 

(l)ICC 
LAR 
LCC 
UP 
LIPT 
RICx 
RSCx 
SAR 
SMS 
SNS 
STCx 

(l)TCM 
TDC 



TYPE 

A 
A 
K 
K 
K 
K 
K 
K 
K 
A 
E 
B 
K 
K 
K 
B 
K 
K 



ADDR 

R 
R 
R 
R 
R 
P 
R 
R 
P 
R 
N 
R 
R 
R 
P 
P 
R 
R 



TAG 

N 
N 
N 
N 
N 
N 
N 
N 
N 
N 
P 
P 
N 
N 
N 
P 
N 
N 



DECR 
R 

R 

N 

N 

N 

N 

N 

N 

N 

U(4) 

U(6) 

U(4) 

N 

N 

N 

II/4) 

R 

N 



IND 
P 
P 
P 
P 

F 
N 
P 
P 
N 
P 
N 
P 
P 
P 
N 
P 
P 
P 
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MNEMONIC 


TYPE 


ADDR 


TAG 


DECR 


IND 


TWT 


K 


R 


N 


N 


P 


WTR 


A 


R 


N 


U(4) 


P 


XMT 


A 


R 


N 


R 


P 



( 1 ) A count field in the high-order position of the decrement 
is assembled from the fourth subfield of the variable field. 
For example, 

ICC ,„4 

IBM 1301 Disk and 7320 Drum File Orders 

The following disk and drum file orders are recog- 
nized by map. The symbolic order should be written: 

Location DORD access and module, track, record 

and assembles as ten bcd digits in two successive loca- 
tions. 





ACCESS AND 






MNEMONIC 


MODULE 


TRACK 


RECORD 


DEBM 


P 


P 


P 


DNOP 


P 


P 


P 


DREL 


P 


P 


P 


DSAI 


P 


P 


P 


DSBM 


P 


P 


P 


DSEK 


P 


P 


P 


DVCY 


P 


P 


P 


DVHA 


P 


P 


P 


DVSR 


P 


P 


P 


DVTA 


P 


P 


P 


DVTN 


P 


P 


P 


DWRC 


P 


P 


P 


DWRF 


P 


P 


P 



The access/module and track subfields may be any 
symbolic expression. They are evaluated in the normal 
manner and converted to bcd. The low-order two char- 
acters of the access/module subfield and the low-order 
four characters of the track subfield are inserted into 
the instruction. The record subfield is taken as alpha- 
meric u.ata, ana the urst two cuaracters are used. r\. 
dnop ( 1212 8 ) order is inserted in the last two charac- 
ter positions of the second word. 

IBM 7340 Hypertape Orders 

The following Hypertape orders are recognized by 
map. The symbolic order should be written: 

Location HORD Tape unit ( if required ) 

and assembles as two ( or three for hsbr and hsel ) bcd 
characters, left -justified in the word. Locations contain- 
ing two-character oiders are filled with trailing hnop 
( 1212 8 ) codes. Three-character orders are repeated in 
the rightmost three characters. 



NEMONIC 


TAPE UNIT 


HBSF 


N 


HBSR 


N 


HCCR 


N 


HCHC 


N 


HCLN 


N 


HEOS 


N 


HERG 


N 


HFPN 


N 


HNOP 


N 


HRLF 


N 



MNEMONIC 


TAPE UNIT 


HRLN 


N 


HRUN 


N 


HRWD 


N 


HSBR 


R 


HSEL 


R 


HSKF 


N 


HSKR 


N 


HUNL 


N 


HWTM 


N 



Any symbolic expression may be used in the tape unit 
subfield. The expression is evaluated and converted to 
bcd, and the low-order character is used as the Hyper- 
tape unit number ( 0-9 ) . 



Appendix B: 7090 Macro-Expansions of 7094 
Instructions 

When assembling in the 7090 mode, certain 7094 in- 
structions are replaced by equivalent 7090 macro- 
instructions. The expansions of these macro-instructions 
are provided in this appendix. 

The expansions are divided into groups in which only 
a few instructions vary from the given operation code. 
The generic macro-expansion of each group is given 
with the necessary substitutions. 

In this appendix, the symbols e.i, e.2, e.3, and e.4 
are generated by the expansions as names of temporary 
storage locations. However, these symbols must be de- 
fined by the programmer or they will be virtual. The 
symbol is generated and defined by the expansion even 
if the mode of the created symbol switch is nocrs. 

Relative addressing must be used carefully when 
7090 macro-expansions of 7094 instructions are used. 
The reason for this, of course, is that the single macro- 
instruction appearing in the source program will be 
replaced by a group of 7090 instructions during 
assembly. 

For example, at first glance the following sequence 
of instructions appears to be a loop that will form 
five, double-precision, floating-point products, where 

1. the first factor of each product is composed of the 
contents of locations alpha + i and BETA + i 
(i = 0,1,2,3,4), 

2. the second factor is composed of the contents 
of locations mult and mult+1, 

3. each product replaces its first factor in storage, 
and 

4. multiplication does not occur if the contents of 
alpha + i are negative. 



XXX 



AXT 


5,2 






CLA 


ALPHA + 5,2 






LDQ 


BETA + 5,2 






TMI 


XXX + 3 






DFMP 


MULT 






STO 


ALPHA + 5,2 






STQ 


BETA + 5,2 






TIX 


*-6,2,l 
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However, since the macro-instruction dfmp will be 
replaced by a macro-expansion consisting of 12 in- 
structions (see below), the tmi and tix instructions 
in this sequence would both cause transfers to some 
"unknown" instruction in the macro-expansion. 
Similarly, the sequence 

SCD * + l,2 

TXL NAME,4,** 

would result in an error since the *1 indicates an in- 
struction in the macro-expansion of the scd instead of 
the txl instruction as intended. 

When assembling in the 7094 or 7094 n mode, the 
macro-operations listed in this section are automati- 
cally purged. 
Group 1. pca and pcd 
For pca, take w = A and z = 20. 
For pcd, take w = D and z = 2. 
The expansion is then 

PCw Y,T 



DFop 





PXw 


Y,T 




TZE 


* + 3 




SUB 


= lBz 




SSP 




Group 2. sca and scd 






For sca, take w = A. 






For scd, take w = D. 






The expansion is then 






SCw Y,T 








SXA 


* + l,T 




AXC 


** r r 




SXw 


Y,T 




LXA 


*-2,T 



Group 3. dfad, dfsb, dfam, and dfsm 
For dfad, take op = ad. 
For dfsb. take op = sb. 
For dfam, take op = am. 
For dfsm, take op = sm. 

In this and the following groups, the expansion below 
is also used: 



(SAVE 



Y,T 



NOP 


Y,T 


STO 


E.l 


CLA* 


*-2 


STA 


*+2 


STT 


* + l 


PXA 


,0 


SUB 


*-l 


SXA 


CRS,4 


PAC 


0,4 


CLA 


E.l 



There are four forms for these expansions: 
DFop Y,T 



STQ 


E.l 


Fop 


Y,T 


STO 


E.2 


XCA 




FAD 


E.l 


Fop 


Y+l/T 


FAD 


E.2 



DFop 
or DFop 



DFop* 



** Q 



CRS 
Y,T 



CRS 



NOP 


,T 


STQ 


E.l 


Fop* 


*-2 


STO 


E.2 


TXI 


* + l,T,-l 


XCA 




FAD 


E.l 


Fop* 


*-7 


FAD 


E.2 


TXI 


* + l,T,l 


AXT 


,0 


SXA 


CRS,4 


LAC 


*-2,4 


DFop 


0,4 


AXT 


,4 


(SAVE 


Y,T 


CLA 


E.l 


DFop 


0,4 


AXT 


,4 



Group 4. dld and dst 

For dld, take op = ld, opa = cla, and opb = ldq. 

For dst, take op = st, opa = sto, and opb = stq. 

There are four forms for these expansions: 



Dop 


Y,T 










opa 


Y,T 






opb 


Y+1,T 


Dop 


** nr 










opa 


,T 






TXI 


* + l,T,-l 






opb* 


*-2 






TXI 


* + l,T,l 


Dop 


** 






or Dop 


**,0 










opa 









SXA 


* + 3,4 






LAC 


*-2,4 






opb 


1,4 






AXT 


A 


Dop* 


Y,T 










(SAVE 


Y,T 






IFT 


/opa/ = /STO/ 






CLA 


E.l 






opa 


0,4 






opb 


1,4 




CRS 


AXT 


** 4 



^roup o. dfmf 

There are four forms for this expansion: 



DFMP 



Y,T 



DFMP 



K rp 



STO 


E.l 


FMP 


V T 


STO 


E.2 


LDQ 


Y,T 


FMP 


E.l 


STQ 


E.3 


STO 


E.4 


LDQ 


Y+i/r 


FMP 


E.l 


FAD 


E.2 


FAD 


E.3 


FAD 


E.4 


NOP 


**,T 


STO 


E.l 


FMP* 


*-2 
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DFMP 
or DFMP 



DFMP" 



**,0 

CRS 

Y,T 

CRS 



Group 6. dfdp and dfdh 
For dfdp, take w = P. 
For dfdh, take w = H. 

There are four forms for these expansions: 



STO 


E.2 


LDQ* 


*-4 


FMP 


E.l 


STQ 


E.3 


STO 


E.4 


TXI 


* + l,T,-l 


LDQ* 


*-9 


TXI 


* + l,T,l 


FMP 


E.l 


FAD 


E.2 


FAD 


E.3 


FAD 


E.4 


AXT 


**,0 


SXA 


CRS 


LAC 


*-2,4 


DFMP 


0,4 


AXT 


** 4 


(SAVE 


Y,T 


CLA 


E.l 


DFMP 


0,4 


AXT 


**,4 



DFDw 



Y,T 



DFDw 



»,T 



DFDw ** 

or DFDw **,0 



CRS 
DFDw* Y,T 



CRS 



STQ 


E.l 


FDw 


Y,T 


STO 


E.2 


STQ 


E.3 


FMP 


Y+LT 


CHS 




FAD 


E.2 


FAD 


E.l 


FDw 


Y,T 


XCA 




FAD 


E.3 


NOP 


,T 


STQ 


E.l 


FDw* 


*-2 


STO 


E.2 


STQ 


E.3 


TXI 


* + l,T,-l 


FMP* 


*-6 


CHS 




FAD 


E.2 


FAD 


E.l 


TXI 


* + l,T,l 


FDw* 


*-ll 


XCA 




FAD 


E.3 


AXT 


**,o 


SXA 


CRS.4 


LAC 


*-2,4 


DFDw 


0,4 


AXT 


**,4 


(SAVE 


Y,T 


CLA 


E.l 


DFDw 


0,4 


AXT 


**,4 



Appendix C: Operation Code Formats 

The operation code formats to be used with the opd 
and opvfd pseudo-operations are given in this ap- 
pendix. 

Operations 

Entries are made in the Combined Operations Table 
for all opd and opvfd pseudo-operations, since the 
lookup process is the same as for any other symbol. To 
specify machine operations using opvfd, the general 
form of this entry is 

6/A,5/0,l/IND,2/ADD,2/TAG,2/DEC,18/V 
where each group of bits in the instruction word is 
specified by an octal number. The same general form 
is used for opd except that the 36-bit word is specified 
as a whole by a 12-digit octal number that will result 
in the same bit structure. 

In this format, V varies with adjective code A (de- 
scribed below). The fields add, tag, and dec refer to 
address, tag, and decrement, respectively. The follow- 
ing code is used: 

Field required 

1 Field permissible 

2 Field unexpected but allowed 

3 Field not permissible 

A 1 for ind indicates that indirect addressing is per- 
mitted, and a indicates that it is not permitted. 

The seven bits specifying fields ind, add, tag, and 
dec are denoted by fr ( Fields Required ) . 

Pseudo-Operations 

The general form of the entry for pseudo-operations 
in the Combined Operations Table is 

06/A, 12/N, 18/0 
where A is the adjective code and N defines a specific 
pseudo-operation under that adjective code. 

The single exception is the macro call (adjective 
code 62). The format for this entry is 

06/62, 12/C, 3/SC, 15/L 
where c is the number of parameters, sc is symbol 
creation information, and l is the location of the in- 
ternal prototype. Adjective 62 is not allowed with opd 
and opvfd pseudo-operations. 

Adjective Codes 

The following list of octal adjective codes gives the 
type of operation to which each applies. 



CODE (OCTAL) 


OPERATION TYPE 




40 


A 




41 


Prefix 




42 


Input/Output Command 




43 


B 




44 


C 




45 


D 
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rODF fOPTAI.1 



OPERATION TYPE 



TVPF r» TMQ r TRTTr"TTr>MG 



( 4.*} 



46 


E 


47 


Select 


50 


Disk and Drum Channel Commands 




(4 fields) 


51 


Disk and Drum Channel Commands 


52 


Boolean Variable 


53 


Disk File and Drum File Orders 


54 


Unexpanded 7094 Instructions 


55 


Hypertape Orders 


*56 


Special Internal Code 


*57 


Special Internal Code 


CODE (OCTAL) 


PSEUDO-OPERATION TYPE 


60 


Macro Definition 


61 


Macro Related 


*62 


Macro Call 


63 


Location 


64 


Storage Allocation 


65 


Decimal Symbol Definition 


66 


Boolean Symbol Definition 


67 


Operation Defining 


70 


Dup and Skipping 


71 


Data Generating 


72 


Nongenerative 


73 


Absolute Assembly 


*74 


Commentary 


75 


Miscellaneous 


76 


Special System 


77 


List Control and Debug 


This adjective code is not usable with OPD and OPVFD 


pseudo operations. 








TYPE A INSTRUCTIONS (4u) 

The entry is 

O6/40,O5/0,O7/FR,O6/0,O12/OPCODE 
where opcode is an octal machine code written with the 
prefix in the first digit. For example, opcode for the in- 
struction txi would be 1000. 

PREFIX OPERATIONS ( 41 ) 

This entry is 

06/41 O5/0 07/FR O6/0 012/OPCODE 
where opcode is written with the prefix in the first digit. 
For example, opcode for the instruction pom would be 
1000. 

INPUT/OUTPUT COMMANDS ( 42 ) 

The entry is 

O6/42,O5/0 5 O7/FR,O3/N,O3/0,O12/OPCODE 
where opcode is written with the prefix in the first digit. 
For example, opcode for the instruction tch would be 
1000. If the instruction is a nontransmitting command, 
N = 2. 

TYPE B INSTRUCTIONS ( 43 ) 

The entry is 

O6/43,O5?0,O7/FR,O6/0,O12/OPCODE 
TYPE C INSTRUCTIONS ( 44 ) 

The entry is 

O6/44,O5/0,O7/FR,O6/0,O12/OPCODE 

54 



O6/45,O5/0,O7/FR,O6/0,O12/OPCODE 
TYPE E INSTRUCTIONS ( 46 ) 

j. ne ususj. lOrmai is 

O6/46,O5/0,O7/FR,O3/S, 015/EA 
where S is the sign of the operation: 

If S = 0, opcode would be +0760. 

If S = 1, opcode would be - 0760. 
ea is the actual extended address of the instruction. 

SELECT INSTRUCTIONS ( 47 ) 

The entry is 

O6/47,O5/0,O7/FR,O3/0,O3/E,O6/C,O6/OPCODE 
opcode is the Select type, as follows: 

= Read 
1= Write 

2 = Set Density High 

3 = Set Density Low 

4 = Rewind 

5 = Rewind Unload 

6 = Backspace Record 

7 = Backspace File 
10=WriteEndofFile 

C is the channel number of Select, starting at 1 for 
Channel A. 

E is the equipment code and has the following signi- 
ficance: 

= Decimal Tape 

1 = Binary Tape; or either Binary or Decimal Tape 

2 = Card Reader 

3 = Punch 

4 = Decimal Printer 

5 = Binary Printer 

See "Select Type" operations for specific address 
field requirements. 

DISK AND DRUM CHANNEL COMMANDS ( 50 ) 

The entry is 

O6/50,O5/0,O7/FR,O6/0,O12/OPCODE 
DISK AND DRUM CHANNEL COMMANDS ( 51 ) 

The entry is 

O6/51 ) O5/0,O7/FR,O3/N,O3/0,O12/OPCODE 
where N = 2 if a 1 in bit position 19 is part of the 
operation code. 

BOOLEAN VARIABLE ( 52 ) 
Tn<^ (*n+r\7 ic 

O6/52,O5/0,O7/FR,O6/0,O12/OPCODE 
where the high-order bit of opcode is always on. 

DISK FILE AND DRUM FILE ORDERS ( 53 ) 

The format is 



Uu/ oo,Uu/ u,Ui/ ACCi,*JZ/ i riiv, Uz/ nc,U, 
O6/0,O12/ORCODE 



orcode is the order, written in external bcd notation. 
For example, drel with an order code of 04 would be 
written 1204. 

The fields acc, trk, and rec refer to the access 
module, track, and record, respectively. Encoding is: 
1 Field permissible 

UNEXPANDED 7094 INSTRUCTIONS ( 54 ) 

The entry is 

O6/54,O5/0,O7/FR,O6/0,O12/OPCODE 

HYPERTAPE ORDERS ( 55 ) 

The entry is 

O6/55,O6/0,O2/ADD,O10/0,O12/OPCODE 
The following is a list of pseudo-operations cor- 
responding to specific A's and N's. 



A 


N 


PSEUDO-OPERATION 


60 





MACRO 


61 





IFT 




1 


IFF 




2 


IRP 




3 


SET 




4 


ORGCRS 




5 


NOCRS 




6 


ENDM 


63 





USE 




1 


BEGIN 




2 


ORG 


64 





BSS 




1 


BES 




2 


COMMON 




3 


EVEN 




4 


LORG 




5 


LDIR 


65 





EQU (andSYN) 




1 


MAX 




2 


MIN 


66 





BOOL 




1 


LBOOL 




2 


RBOOL 


67 





OPD 




1 


OPVFD 




2 


OPSYN 


70 





DUP 




1 


GOTO 


71 





OCT 




1 


DEC 




2 


BCI 




3 


LIT 




4 


VFD 


72 





QUAL 




1 


ENDQ 




2 


CONTRL 




3 


FILE 




4 


ENTRY 




5 


LABEL 


73 





ABS 




1 


FUL 




2 


TCD 




3 


PUNCH 




4 


UNPNCH 


75 





ETC 




1 


REM 




2 


NULL 



76 



77 



N 


PSEUDO-O 


3 


END 


4 


PURGE 





CALL 


1 


SAVE 


2 


SAVEN 





UNLIST 


1 


LIST 


2 


TITLE 


3 


DETAIL 


4 


EJECT 


5 


SPACE 


6 


LBL 


7 


PCC 


8 


INDEX 


9 


PMC 


10 


TTL 


11 


PCG 


12 


KEEP 



Appendix D: IBMAP-FAP Incompatibilities 

This appendix lists the incompatibilities that will occur 
when assembling a fap or ibsfap program using ibmap. 

1. All fap machine operations and extended ma- 
chine operations will assemble properly in map. 

2. All fap pseudo-operations pertaining to the up- 
date facility have no counterpart in map. They are: 



DELETE 


NUMBER 


UMC 


ENDFIL 


REWIND 


UNLOAD 


ENDUP 


SKIPTO 


UPDATE 


IGNORE 


SKPFIL 





3. The following fap pseudo-operations have no 
counterpart in map. (Since map treats undefined op- 
erations as remarks, some of these operations do not 
affect assembly.) 



IFEOF 


TAPENO 


LOC 


704 


PRINT 


9LP 


SST 





4. The following fap pseudo-operations must be 
replaced by the indicated map equivalent: 



FAP 


MAP 


HEAD,HED 


QUAL,ENDQ 


BCD 


BCI 


MOP 


MACRO 


MAC 


Standard macro-instruction 


END (of macro) 


ENDM 


RMT 


USE and USE PREVIOUS 



( Note that qual permits nesting of qualifiers, whereas 
head does not.) 

The following is an example of a program segment 
coded first in fap and then in map. 



ALPHA 



RMT 

BSS 

RMT 



RMT 
EXTERN 



10 
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Djvr 




SPC 




TSX 


$SUB,4 


USE 


RMT 


BSS 


10 


USE 


PREVIOUS 


BEGIN 


RMT, ALPHA 


Leave 




symbols 




undefined 




EJECT 




SPACE 




TSX 


SUB,4 (remov* 



specify external names) 

5. The following pseudo-operations have identical 
names in fap and map but differ in context or meaning: 

IFF 

Variable field specifications are different. 
COMMON 

COMMON counter increments forward in MAP. 
DUP 

In MAP, an S-value may be used for the instruction and 
iteration counts. A FAP sequence such as 
N EQU 5 

DUP 1,N 

must be changed in MAP to 
N SET 5 

DUP 1,N 

EQU,SYN 

In MAP, these apply to symbol definitions only and 
cannot be used where an S-value is required; see DUP 
above. 
OPD.OPVFD 

The flag bits in the field are different ( see Appendix C ) . 
MACRO 



In MAP, this is used as 
NAME MACRO 

and may not be used as 
MACRO 

NAME 



A,B,Q. 



6. The following fap pseudo-operations have their 
equivalent option specified on the sibmap card: 

REF 
7090 
COUNT 

7. In map, the null pseudo-operation rather than 
equ * should be used for symbol definition, because of 
the limited size of the Pseudo-Operation Dictionary. 

8. The following fa.p pseudo-operations will as- 
semble properly in map: 



ABS 


FULL 


ORGCRS 


BCI 


INDEX 


PCC 


BES 


LBL 


PMC 


BOOL 


LIST 


REM 


BSS 


MAX 


SET 


*CALL 


MIN 


SPACE 


DEC 


NOCRS 


TCD 


DETAIL 


NULL 


TITLE 


EJECT 


OCT 


UNLIST 


ENTRY 


OPSYN 


TTL 


ETC 


ORG 


VFD 



y. in map, virtual entries in tne control dictionary 
correspond to the transfer vector of fap except that 
ibldr provides direct rather than indirect references. 

10, In map, normal arithmetic truncates to 15 bits 
in the address field, 3 in the tag, and as specified in 
tiiC decrement, vfd syrnuGiic antumetic truncates to 
a maximum of 20 bits. Boolean arithmetic truncates to 
18 bits. 



Appendix E: The MAP BCD Character Code 

The map bcd character code is shown in octal form in 
in the following table with the corresponding ibm 
punched card code. 



*CALL generates a different calling sequence in MAP. 



CHARACTER 


BCD CODE ( OCTAL ) 


CARD CODE 


(blank) 


60 


(blank) 





00 





1 


01 


1 


2 


02 


2 


3 


03 


3 


4 


04 


4 


5 


05 


5 


6 


06 


6 


7 


07 


i 


8 


10 


8 


9 


11 


9 


A 


21 


12-1 


B 


22 


12-2 


C 


23 


12-3 


D 


24 


12-4 


E 


25 


12-5 


F 


26 


12-6 


G 


27 


12-7 


H 


30 


12-8 


I 


31 


12-9 


J 


41 


11-1 


K 


42 


11-2 


L 


43 


11-3 


M 


44 


11-4 


N 


45 


11-5 


O 


46 


11-6 




Ar-I 
If 


11-7 


Q 


50 


11-8 


R 


51 


11-9 


S 


62 


0-2 


X 


63 


0-3 


u 


64 


0-4 


V 


65 


0-5 


w 


66 


0-6 


X 


67 


0-7 


Y 




0-8 


Z 


71 


0-9 


+ (plus) 


20 


12 


— ( minus ) 


40 


11 


/ (slash) 


61 


0-1 


= ( equals ) 


13 


8-3 


( apostrophe ) 


14 


8-4 


( period ) 


33 


12-8-3 


) ( right parenthesis) 


34 


12-8-4 


$ ( dollar sign ) 


53 


11-8-3 


* ( asterisk ) 


54 


11-8-4 


, ( comma ) 


73 


0-8-3 


( ( left parenthesis ) 


74 


0-8-4 
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abs pseudo-operation 33 

Absolute assemblies 6, 33 

Absolute-assembly pseudo-operations 6, 33 

Absolute expression 11 

Absolute origin 6, 9, 15 

Absolute symbols 9 

Adjective codes 53 

Alphameric literal 10 

Alphameric subfield in vfd 19 

Assembly-program language 5 

Asterisk ( * ) 

as an element 10 

in indirect addressing 7 

in relative addressing 12 

remarks card 8 

bcd character code 56 

bci pseudo-operation 18 

begin pseudo-operation 14 

bes pseudo-operation 16 

Binary-place part in fixed-point number 10 

Binary transfer card 32, 33 

Bit count of vfd 19 

Blank common 14, 17, 26 

Blank location counter 14 

bool pseudo-operation 23 

Boolean expressions 11, 23 

Boolean pseudo-operations 5, 23 

Boolean variable code format 54 

bss pseudo-operation 15 

call pseudo-operation 36 

Calling macro-operations 42 

Calling sequence 36 

Comments field 7 

common pseudo-operation 17 

Compiler program 5 

Complex expression 11 

Conditional-assembly in macro-operations 44 

Conditional-assembly pseudo-operations 5, 23 

Constants 9, 17 

contrl pseudo-operation 26 

Control section 25 

Control-section pseudo-operations 5, 25 

Created symbols in macro-operations 46 

"Current" location counter 6 

Data-generating pseudo-operations 5, 17 

Data item, decimal 9 

Debugging dictionary 15, 16, 21, 33 

dec pseudo-operation 17 

Decimal data item 9 

Decimal integer 9 

Decimal literals 9 

Defining macro-operations 40 

Defining symbols 8 

detail pseudo-operation 34 

Dimension 15, 16, 21, 33 

Disk and Drum channel command format 54 

Disk file and drum file order format 54 

Disk file and drum file orders 51 

Double-precision literals 10, 16, 20 

dup pseudo-operation 20 

eject pseudo-operation 34 

Elements in expressions 10 

end pseudo-operation 32 



endm pseudo-operation 40, 42 

endq pseudo-operation 25 

entry pseudo-operation 26 

equ pseudo-operation 21 

Error checking 6 

Error returns 36 

etc pseudo-operation 32 

Evaluating expressions 11 

even pseudo-operation 16 

Expansions 

of call 36 

in macro-operations 40, 42 

of save 37 

Exponent part 

fixed-point number 10 

floating-point number 9 

Expression** 11 

Expressions 11 

absolute 11 

Boolean 11 

complex 11 

elements of 10 

evaluation of 11 

operators in 11 

relocatable 11 

rules for forming 11 

symbols in 12 

terms in 11 

writing of 10 

Extended machine operations 49 

External file name 27 

fap-ibmap incompatibilities 55 

Fields 

comments 7 

instruction 6 

name 7 

operation 7 

sequence 8 

variable 7 

File-description pseudo-operations 5, 27 

File identification name 30 

File name 30 

external 27 

File options 

activity 28 

block sequence 29 

block size 28 

block-size check 30 

checkpoint 29 

checkpoint location 29 

check sum 29 

conversion 30 

disk/drum cylinder count 29 

disk/drum starting cylinder number 29 

disk/drum write-checking 29 

file close 29 

file density 29 

file mounting 28 

file usage 28 

Hypertape 30 

Hypertape reel switching 29 

label density 29 

mode 29 

nonstandard-label routine 30 

operator file list 28 
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pool-attacnment ou 

reel handling 28 

file pseudo-operation 27 

File serial number 30 

File unit 

primary 27 

secondary 27 

File unit-assignment option 27 

Fixed-point number 10 

Floating-point number 9 

Format 

Boolean variable code 54 

disk and drum channel commands 54 

disk and drum file orders 54 

Hypertape orders 55 

Input/Output Commands 54 

operation code 53 

prefix operation code 54 

select instruction code 54 

type A instruction code 54 

type B instruction code 54 

type C instruction code 54 

type E instruction code 54 

unexpanded 7094 instruction code 55 

ful pseudo-operation 33 

goto pseudo-operation 24 

Hypertape order format 55 

Hypertape orders 51 

ibmap-fap Incompatibilities 55 

iff pseudo-operation 23, 44 

ift pseudo-operation 23, 44 

Immediate symbols 9, 22 

index pseudo-operation 35 

Indirect addressing 7 

Input/output command format 54 

Instruction count of dup 20 

Instruction fields 6 

Instructions, type D 9, 23, 54 

Integer 

decimal 9 

octal 10 

irp pseudo-operation 46 

Irrelevant subfield 7 

Iteration count of dup 20 

keep pseudo-operation 15. 21. 32 

label pseudo-operation 30 

Languages 

assembly program 5 

compiler 5 

machine 5 

map 5 

lbl pseudo-operation 34 

lbool pseudo-operation 23 

ldir pseudo-operation 17 

Linkage Director 17, 37 

List-control pseudo-operations 6, 33 

list pseudo-operation 34 

lit pseudo-operation 19 

Literal Pool 10, 16, 19 

Literals 9 

alphameric 10 

decimal 9 

double-precision 10, 16 

octal 10 

Load address 6 

Location-counter pseudo-operations 5, 14 

Location counter // 14, 17, 26 

Location counters 6, 14 

"current" 6 

Location symbols 8 

lorg pseudo-operation 17 



iviacnine-ianguage program o 

Machine operations 48 

extended 49 

select-type extended 49 

sense-tvpe extended 49 

7090 ' 48 

7094 50 

Macro-defining pseudo-operations 6, 40 

Macro-definition heading card 40 

Macro-definitions 40 

Macro-expansions 40, 42 

inserting instructions in 44 

of 7094 instructions 51 

Macro-instructions 40, 42 

delimiting parameters in 42 

in macro-definitions 43 

parameters in 43 

Macro-operation facility 6, 40 

Macro-operations 

conditional assembly in 44 

nested 45 

qualification in , 45 

macro pseudo-operation 40 

Macro-related pseudo-operations 6, 45 

map bcd character code 56 

map language features 5 

map pseudo-operations 14 

max pseudo-operation 22 

min pseudo-operation 22 

Miscellaneous pseudo-operations 6, 32 

Modal and dimensional information 15, 16, 21, 33 

Mode 15, 16, 21, 33 

Name field 7 

Names 

external file 27 

file 30 

Nested dup pseudo-operations 20 

Nested macro-operations 45 

Nested qualification 25 

nocrs pseudo-operation 47 

nopool option 30 

null pseudo-operation 21 

Null subfield 7 

Numbers 

fixed point 10 

floating point 9 

Object program 5 

oct pseudo-operation 18 

Octal integers 10 

Octal literals 10 

Octal subfield in vfd 19 

opd pseudo-operation 31, 53 

Operation code formats 53 

Operation-defining pseudo-operations 5, 31 

Operation field 7 

Operators 

in Boolean expressions 12 

in expressions 11 

relational 23 

opsyn pseudo-operation 31 

Options 

disk and drum cylinder count 29 

disk and drum starting-cylinder number 29 

disk and drum write-checking 29 

file activity 28 

file block sequence 29 

file block size 28 

file block-size check 30 

file checkpoint 29 

file checkpoint location 29 

hie check-sum 29 

file close 29 
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file conversion 30 

file density 29 

file label density 29 

file mode 29 

file mounting 28 

file nonstandard-label routine 30 

file reel handling 28 

file unit assignment 27 

file usage 30 

Hypertape 30 

Hypertape reel switching 29 

operator file list 28 

opfvd pseudo-operation 31, 53 

Orders 

disk and drum file 51 

Hypertape 51 

Ordinary symbols 8 

org pseudo-operation 15 

orgcrs pseudo-operation 47 

Origin 

absolute 9, 15 

relocatable 9 

Parameters 

delimiting in macro-instructions 43 

in macro-instructions 43 

pcc pseudo-operation 33 

pcg pseudo-operation 36 

pmc pseudo-operation 35 

Prefix codes 50 

Prefix operation code format 53 

Primary file unit 27 

Principal part 

fixed-point number 10 

floating-point number 9 

Prototype card images 41 

Prototype instructions 41, 42 

substitutable arguments in 44 

text in 44 

Pseudo-operation 5 

Pseudo-operation code formats 53, 55 

Pseudo-operations 

abs 33 

absolute-assembly 6, 33 

bci 18 

BEGIN 14 

BES 16 

BOOL 23 

Boolean 5, 23 

bss 15 

call 36 

COMMON 17 

conditional-assembly 5, 23 

contrl 26 

control-section 5, 25 

data-generating 5, 17 

dec 17 

detail 34 

dup 20 

EJECT 34 

END 32 

ENDM 40, 42 

endq 25 

ENTRY 26 

EQU 21 

ETC 32 

EVEN 16 

FILE 27 

file-description 5, 27 

ful 33 

iff 23, 44 

ift 23, 44 

INDEX 35 

irp 46 



LABEL 30 

LBL 34 

LBOOL 23 

LDIR 17 

list 34 

list-control 6, 33 

lit 19 

location-counter 5, 14 

lorg 17 

macro 40 

macro-defining 6, 40 

macro-related 6, 45 

max 22 

min 22 

miscellaneous 6, 32 

nocrs 47 

null 21 

OCT 18 

opd 31,53 

operation-defining 5, 31 

opsyn 31 

opvfd 31, 53 

org 15 

orgcrs 47 

pcc 33 

pcg 36 

pmc 35 

punch 33 

QUAL 24 

RBOOL 23 

REM 32 

return 38 

save 37 

SAVEN 38 

set 9,21,22 

space 34 

special systems 6, 36 

storage-allocation 5, 15 

symbol-defining 5, 21 

symbol-qualifying 5, 24 

syn 21 

tcd 33 

title 34 

TTL 36 

UNLIST 34 

UNPNCH 33 

USE 14 

VFD 19 

punch pseudo-operation 33 

purge pseudo-operation 47, 52 

qual pseudo-operation 24 

Qualification 

in macro-operations 45 

nested 25 

Qualified section 25 

Qualified symbol 25 

rbool pseudo-operation 23 

Relational operator 23 

Relative addressing 12 

Relocatable assemblies 6 

Relocatable expressions 11 

Relocatable origin 9 

Relocatable segments 25 

Relocation properties of symbols 9 

rem pseudo-operation 32 

Remarks card 8 

Retention period for files 30 

return pseudo-operation 38 

Returns, error 38 

S-value 9 

save pseudo-operation 37 

saven pseudo-operation 38 
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Secondary hie unit zv 

Sections 

control 25 

qualified 24 

Segments, relocatable 25 

ociect inscinction code xormat o-± 

Select-type extended machine operations 49 

Sense-type extended machine operations 49 

Sequence field 8 

Serialization of decks 34 

set pseudo-operation 9, 21, 22 

Source program 5 

space pseudo-operation 34 

Special operations 50 

Special systems pseudo-operations 6, 36 

Storage-allocation pseudo-operations 5, 15 

Subfields , . . : 7 

alphameric in vfd 19 

irrelevant 7 

null 7 

octal in vfd 19 

symbolic in vfd 19 

Subroutines 36 

Substitutable arguments 

combining with text 44 

delimiting in macro 41 

delimiting in prototypes 41 

in macro 40 

in prototypes 41 

Symbol-defining pseudo-operations 5, 21 

Symbol definition 8 

Symbol-qualifying pseudo-operations 5, 24 

Symbolic instructions 6 

Symbolic subfield in vfd 19 

Symbols 8 

absolute 9 

created in macro-operations 46 

definition of 8 

immediate 9, 22 

location 8 

ordinary 8 



qualified 25 

relocation properties of 9 

used in expressions 12 

virtual 9 

syn pseudo-operation 21 

SYSLOC 37 

tcd pseudo-operation 33 

Terms in expressions 11 

Text 

combining with substitutable arguments 44 

in macro prototypes 41 

title pseudo-operation 34 

ttl pseudo-operation 36 

Type A instruction code format 54 

Type B instruction code format 54 

Type C instruction code format 54 

Type D instruction code format 9, 23, 54 

Type E instruction code format 54 

Type letter in vfd 19 

Unexpanded 7094 instruction code format 55 

Units 

primary file 27 

secondary file 27 

unlist pseudo-operation 34 

unpnch pseudo-operation 33 

use pseudo-operation 14 

Variable field 7 

vfd pseudo-operation 19 

Virtual symbols 9 

Writing expressions 10 

1301/7320 file orders 51 

7090 machine operations 48 

7090 macro-expansions of 7094 instructions 51 

7094 machine operations 50 

7340 Hypertape orders 51 

7909 data channel commands 50 

( )ok option 8 

$file card 30 
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